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PREFACE 


This  report  documents  the  COPE  methodology  and  computer  programs. 

Various  sections  of  this  report  are  aimed  at  different  audiences: 

Chapter  1  is  an  introduction  to  COPE  and  to  this  report. 

Chapters  2  and  3  are  intended  for  the  analyst  who  is  concerned 
with  the  modeling  methodology  and  assumptions. 

Chapters  4,  5,  6,  7,  14,  15,  and  16  are  aimed  at  the  user  who 
wants  to  use  the  COPE  model  and  its  preprocessors  in  production  runs,  but 
who  is  not  interested  in  programming  details. 

Chapters  8,  9,  10,  11,  12,  and  13  are  intended  for  the  programmer 
who  wants  a  thorough  understanding  of  the  COPE  computer  code  in  order  to 
implement  it  on  other  machines  or  simply  to  make  changes  to  it. 

The  first  four  appendixes  (A,  B,  C,  and  D)  include  program 
listings  and  sample  cases.  The  sample  cases  are  cumulative  in  the  sense 
that  the  three  PAM  sample  input  sets  should  be  run  using  respectively  the 
three  PAM  sample  runstreams  before  running  the  PREPMS  program.  The  sample 
PREPMS  case  should  then  be  run  using  the  TAPE  11  created  by  the  PAM  runs 
(this  will  result  in  the  output  of  Appendix  C).  Finally,  the  COPE  sample 
case  should  be  run  using  the  TAPE  11  created  by  PAM  and  PREPMS  (this 
should  result  in  the  output  of  Appendix  D).  Running  these  sample  cases 
and  comparing  the  results  with  those  in  the  appendixes  provide  a  check 
for  correct  implementation  of  COPE  and  its  preprocessors  on  other  machines. 

If  discrepancies  are  found  in  this  publication  or  the  associated 
software,  please  send  notice  to: 

Director 

US  Army  Materiel  Systems  Analysis  Activity 
ATTN:  DRXSY-GS  (Mr.  R.  Sandmeyer) 

Aberdeen  Proving  Ground,  MD  21005 

Suggestions  for  improvements  to  this  report  or  the  associated 
programs  may  also  be  sent  to  the  above  address. 

In  addition,  requests  for  magnetic  tape  copies  of  the  COPE 
programs  and  related  files  should  be  sent  to  the  same  address  along  with 
the  appropriate  paperwork  for  such  requests. 

This  report  may  be  updated  by  the  issuing  of  revised  pages. 

The  frequency  of  such  updates  will,  of  course,  depend  on  the  number  of 
errors  requiring  correction,  the  changes  made  in  the  model,  and  the  demand 
for  the  report.  Those  desiring  to  maintain  the  latest  versions  of  the 
report  and  the  programs  should  be  certain  that  they  are  on  the  COPE 
distribution  list  to  be  maintained  by  AMSAA. 
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NOTE  ON  CLASSIFICATION 


This  report  is  unclassified,  however,  when  the  COPE  model  is 
used  for  actual  production  runs,  it  requires  some  classified  inputs.  The 
inputs  used  in  the  sample  cases  (see  Appendixes)  are  correct  data  except 
for  false  values  which  have  been  inserted  in  place  of  those  data  whose 
correct  values  are  classified. 

In  addition,  comment  cards  with  the  characters  "CSEC"  in  columns 
1-4  point  out  places  in  the  program  code  where  fictitious  constants  have 
been  substituted  to  replace  classified  values  in  the  listings  of  PAM  and 
COPE  (Listings  A-l  and  D-l). 

The  following  data  are  classified  (at  the  time  of  publication 
of  this  report)  when  correct  values  are  used  and  identified  as  such: 

In  the  PAM  program:  ETH,  THEMH,  and  DISMH  are  classified  by 
Reference  1  below.  ED  is  classified  by  Reference  2. 

In  PREPMS  and  COPE  programs,  the  values  of  PE,  RNGTTF,  and 
PKTBL,  as  well  as  the  true  seeker  sensitivity  value,  are  all  classified 
by  Reference  1 . 


^Security  Classification  Guide,  Projectile,  155mm,  Cannon  Launched, 
Guided,  XM712,  (CLGP),  dated  24  July  1979. 

^Security  Classification  Guide,  Ground  Laser  Designators,  dated 
16  June  1978. 
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CHAPTER  1 


1.  INTRODUCTION 

1.1  COPE  Background. 

Tradi tional 1y  the  item  level  performance  of  a  weapon  system  has 
been  expressed  in  terms  of  the  firepower  characteristics  of  the  weapon. 

The  weapon  characteristics  normally  included  in  the  computation  of  firepower 
were  range,  accuracy,  lethality,  and  rate-of-fire.  With  the  introduction 
of  more  sophisticated  weapons,  an  awareness  of  the  need  to  include  additional 
factors  in  the  assessment  of  a  weapon's  performance  has  emerged  at  both  the 
decision  and  RSD  levels.  These  additional  factors  have  collectively  been 
referred  to  as  the  "Battlefield  Environment"  and  include  natural  phenomena 
as  well  as  conditions  imposed  on  the  system  by  friendly  and  enemy  forces. 

The  need  for  quantifying  a  weapon  system's  performance  within  the 
battlefield  environment  recently  became  most  critical  with  the  development 
of  the  155mm  XM712  COPPERHEAD  artillery  projectile.  To  study  its  potentially 
degraded  performance  under  some  battlefield  environments,  AMSAA  developed  a 
computer  model  which  is  known  by  the  acronym  COPE  (COPPERHEAD  Operational 
Performance  Evaluation). 

In  addition  to  being  a  model  for  assessing  the  performance  of  a 
weapon  system,  the  model  and  the  manner  of  generating  the  input  requirements 
constitute  a  novel  approach  to  the  evaluation  of  weapon  systems.  This 
approach  results  in  a  manner  of  assessing  the  performance  of  most  weapon 
systems  and  potentially  can  quantitatively  produce  insight  into  the 
performance  of  one  or  more  weapon  systems  which  previously  could  only  be 
treated  subjectively. 

This  report  describes  the  COPE  model  as  currently  used  at  AMSAA 
for  the  assessment  of  COPPERHEAD.  AMSAA  has  modified  the  computer  code  to 
obtain  models  that  analyze  the  performance  of  other  weapon  systems  within 
the  context  of  a  COPE  type  "operational  performance"  analysis.  The  term 
COPE  itself  has  now  come  to  have  two  meanings:  (1)  "Combat  Operational 
Performance  Evaluation"  which  is  the  generic  name  for  all  of  the  derivative 
models  of  the  original  COPPERHEAD  version  and  (2)  "COPPERHEAD  Operational 
Performance  Evaluation"  which  is  the  first  model  in  this  family  of  "Opera¬ 
tional  Performance"  models  and  is  the  one  described  in  this  report. 

The  models  in  the  COPE  family  include: 

( 1 )  COPPERHEAD  Operational  Performance  Evaluation  (COPE)  used  to 
evaluate  the  XM712  COPPERHEAD  artillery  round, 

(2)  Tank  Performance  Evaluator  (TAPE)  used  as  part  of  the  XM1 
tank  evaluation, 

(3)  TOW  Operational  Performance  Evaluator  (TOPE)  used  to  evaluate 
the  TOW  anti-tank  missile, 
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evaluate  HELLFIRE  launched  from  helicopters. 

The  input  requirements  for  these  models  range  from  moderate  to 
massive.  The  TAPE  and  TOPE  models  for  example  require  no  preprocessors  and 
take  less  input  than  the  COPPERHEAD  version.  The  TAEM  program,  on  the 
other  hand,  requires  as  input  results  generated  by  the  very  costly,  long 
running,  TGSM  (Terminally  Guided  Submunition  Model)  program. 

This  report  is  concerned  only  with  the  COPE  model  (in  all  remaining 
sections  of  this  report,  COPE  shall  have  its  second,  narrower  meaning: 
"COPPERHEAD  Operational  Performance  Evaluation");  however,  much  of  what  is 
discussed  applies  to  the  other  models  in  the  family.  Any  of  the  models  of 
the  COPE  family  can  be  obtained  from  AMSAA,  though  at  the  present  time  only 
the  COPPERHEAD  and  tank  versions  have  been  extensively  documented. 

1.2  Overview  of  COPE  Computer  Programs. 

There  are  actually  four  computer  programs  used  in  the  COPPERHEAD 
Operational  Performance  Evaluation.  They  are: 

(1)  The  main  COPE  program  (formerly  called  SLATCH  for  Simple  Look 

at  the  COPPERHEAD)  descended  from  the  original  proposal  put  forward  by  DUSA-OR. 

(2)  The  PAM  (Probability  of  Seeker  Acquisition  and  Round  Maneuver) 
model  used  to  create  the  probability  of  engagement  tables  used  as  input  to 
the  main  COPE  prog'- am.  This  model  is  described  and  documented  more  thoroughly 
in  a  forthcoming  aMSAA  technical  report. 

(3)  The  PREPMS  (Preprocessor  Mass  Storage)  program  that  is  used 
to  create  and  modify  the  word  addressable  mass  storage  file  used  as  the 
COPE  "data  base". 

(4)  The  PR8L0S  (Probability  of  Une-of -Sight)  model  used  to  obtain 
the  probability  of  having  TTne-of-sight  for  the  terminal  phase  of  the 
COPPERHEAD  trajectory. 


COPE  Input  I COPE  Auxlry 


All  four  of  these  programs  are  documented  in  this  report,  though 
the  PAfl  model  is  covered  in  much  less  detail  than  the  other  three  since  a 
more  detailed  treatment  of  it  will  be  published  in  a  separate  report. 

The  relationships  among  the  four  programs  and  the  word  addressable 
"data  base"  file  are  shown  in  Figure  1-1. 

The  major  data  sets  (called  "data  blocks"  later  in  this  report) 
are  put  on  the  data  base  by  PAM  and  PREPMS.  Then  when  one  wishes  to  run 
COPE,  it  is  necessary  only  to  submit  a  string  of  simple  input  commands 
describing  the  cases  to  be  run.  For  example,  when  running  a  case  using 
December  weather  for  0600  (6  a.m.),  one  need' merely  submit  a  card:  HEATHER, 
DECEMBER,  0600  rather  than  read  in  thirty  or  forty  cards  filled  with  the 
appropriate  weather  data.  This  arrangement  makes  it  extremely  simple  to 
run  many  cases  of  COPE  with  relatively  few  input  cards  once  the  data  base  file 
has  been  created. 

Tn  the  event  that  one  wishes  to  run  cases  that  use  a  data  set  not 
on  the  data  base  file,  there  is  a  "temporary"  option  that  allows  one  to 
read  the  data  into  COPE  directly;  however,  if  one  intends  to  run  multiple 
cases  with  such  data,  it  will  be  easier  in  the  long  run  to  read  it  onto  the 
permanent  data  base  file  once  using  the  PREPMS  program  and  then  "call  it 
up"  for  use  as  necessary  in  COPE  by  submitting  the  appropriate  single  card 
command. 


All  four  programs  are  written  in  CPC  FORTRAN  Extended  Version  4. 


1-4 


CHAPTER  2 


2.  DESCRIPTION  OF  COPPERHEAD  MISSION  MODELING 
2.1  Application  Area  of  Simulation. 

The  main  COPE  program  is  a  simulation  of  a  COPPERHEAD  fire 
mission  under  battlefield  conditions.  It  takes  into  account  such  de¬ 
grading  effects  on  designator,  fire  direction  center  (FDC),  artillery 
battery,  and  COPPERHEAD  round  performance  as  meteorological  condi¬ 
tions,  terrain  shielding,  smoke,  dust,  enemy  artillery  preparatory 
fires,  enemy  direct  fire  against  the  designator,  communication  fail¬ 
ures,  and  target  location  error  as  well  as  numerous  factors  that 
affect  COPPERHEAD'S  ability  to  engage  and  hit  a  target. 

The  main  COPE  program  was  designed  to  evaluate  the  oper¬ 
ational  performance  of  the  overall  COPPERHEAD  system  under  battle¬ 
field  conditions. 

The  output  of  the  program  enables  one  to  see  which  factors 
contribute  most  to  the  degrading  of  COPPERHEAD  system  performance  and 
which  are,  therefore,  areas  in  which  performance  improvement  efforts 
should  be  concentrated. 

In  addition,  by  varying  the  input  value(s)  associated  with  a 
particular  factor  and  then  studying  the  results,  one  can  perform  the 
customary  sensitivity  analysis.  A  series  of  such  analyses  can  be 
expected  to  show  that  changes  (within  realistic  limits)  in  some 
factors  have  little  effect  on  overall  system  operational  performance 
whereas  changes  in  other  factors  will  result  in  major  performance  im¬ 
provement  or  degradation. 

By  comparing  those  factors  to  which  system  operational 
effectiveness  is  most  sensitive  with  those  factors  over  which  system 
designers  and  tacticians  have  some  control,  one  can  determine  what,  if 
any,  design  changes  or  employment  doctrine  changes  might  be  made  to 
improve  overall  COPPERHEAD  system  operational  performance.  This 
comparison  and  analysis,  of  course,  is  done  outside  the  COPE  program, 
but  the  resulting  modified  COPPERHEAD  system  and  employment  doctrine 
might  then  be  evaluated  in  the  COPE  model  or  a  descendent  of  it. 

Finally,  several  derivative  models  have  been  developed  from 
an  earlier  COPE  program  (SLATCH  version  3.2)  and  are  in  use  for 
evaluating  tanks,  TOW,  and  Hellfire  under  battlefield  conditions. 

These  models  allow  limited  but  informative  comparisons  of  the 
operational  performance  of  the  different  weapon  systems. 
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2.2  Description  of  Model. 

2.2.1.  Outline  of  COPPERHEAD  Mission.  The  heart  of  the  main 
COPE  program  is  the  Monte  Carlo  simulation  of  a  potential  COPPERHEAD  fire 
mission.  This  simulation  consists  of  a  series  of  steps  that  would  occur 
in  an  actual  COPPERHEAD  fire  mission.  For  a  successful  mission,  these 
steps  start  with  the  uninasking  from  terrain  shielding  of  a  target  and  end 
with  the  killing  of  a  target  by  COPPERHEAD.  For  an  unsuccessful  mission, 
the  steps  end  before  the  target  is  killed. 

The  steps  are  grouped  into  three  series  bounded  by  four  major 
events.  The  following  outline  gives  the  four  major  events  as  well  as  the 
steps  (or  tests)  that  must  be  passed  to  reach  the  next  major  event.  All 
steps  and  events  occur  in  the  order  listed. 

This  describes  the  tests  when  the  so-called  "shooting  gallery" 

1 ine-of-sight  model  is  used.  Following  the  list  is  a  description  of  the 
modi f ications  required  when  the  "random  occurrence"  1 ine-of-sight  model  is 
used. 


Event  1.  A  target  (one  or  more  target  vehicles)  unmasks 
(i.e. ,  enters  a  region  within  1 ine-of-sight  of  the  desig¬ 
nator  operator's  position).  This  is  termed  an  "occasion" 
and  begins  the  simulation  of  the  potential  COPPERHEAD 
mission. 

Test  1:  Has  the  designator  operator  survived  enemy  pre¬ 
paratory  artillery  fires  up  to  the  present  time? 

Test  2:  Is  the  target  within  the  meteorological  visibil¬ 
ity  range  limit  of  the  designator  operator  for  the  present 
weather  conditions? 

Test  3:  Is  the  target  within  the  designation  range  of  the 
laser  designator  system  being  played? 

Test  4:  Did  the  designator  operator  detect/acquire  the 
ta'rget  before  it  again  became  masked  by  terrain? 

Test  5:  Is  the  line-of-sight  from  designator-to-target 
sufficiently  free  of  smoke  that  the  designator  operator  can 
see  and  designate  the  target? 

Test  6:  Is  the  line-of-sight  from  designator-to-target 
sufficiently  free  from  dust  for  the  designator  operator 
(D.O.)  to  see  and  designate  the  target? 

Test  7:  Is  the  target  sufficiently  far  away  from  the 
designator  operator  that  he  will  stay  and  designate  rather 
than  "bail-out?" 
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Event  2:  The  designator  operator  has  acquired  a  target 
and  decides  to  engage  it  (i.e.  ,  call  for  COPPERHEAD  fire 
against  it).  This  is  termed  an  "attemped  engagement." 


Test  8:  Is  the  designator  operator  able  to  communicate 
with  the  fire  direction  center  (FDC)? 

Test  9:  Does  the  message  which  the  designator  operator 
sends  to  the  fire  direction  center  contain  the  correct  in¬ 
formation  and  does  the  FDC  interpret  it  correctly? 

Test  10:  Is  the  target  still  (after  time  has  been  spent 
on  communication  and  preparing  to  fire  the  mission)  suf¬ 
ficiently  far  away  tiiat  the  designator  operator  will  stay 
and  designate  rather  than  "bail-out?" 

Test  11:  Does  the  designator  operator  still  have  line-of- 
sight  to  the  target? 

If  tests  8  through  11  are  all  passed,  then  conditions  are 
such  that  a  COPPERHEAD  fire  mission  occurs.  This  leads  to: 

Event  3:  The  battery  is  ready  to  fire  and  the  designator 
is  ready  to  designate.  A  COPPERHEAD  round  is  fired.  This 
is  termed  a  "shot". 

Test  12:  Does  the  designator  operator  still  have  line- 
of-sight  to  the  target  during  the  final  critical  time  inter¬ 
val  of  the  COPPERHEAD  trajectory? 

Test  13:  Has  the  designator  operator  been  warned  to  begin 
lasing  the  target  or  has  he  seen  the  first  COPPERHEAD  round 
of  this  fire  mission  already  impact? 

Test  14:  Does  the  designator  survive  direct  fire  from  the 
target  being  designated  and  is  the  1 i ne-of-si ght  to  the  tar¬ 
get  unobscured  by  direct  fire  rounds  landing  in  front  of  the 
designator? 

Test  15:  Is  the  COPPERHEAD  round  just  fired  reliable? 

Test  16:  Is  the  line-of-sight  from  the  designator  operator 
to  the  target  vehicle  unobscured  by  small  terrain  features? 

Test  17:  Does  the  round  come  sufficiently  close  to  the  tar¬ 
get  for  the  seeker  to  receive  enough  reflected  laser  energy 
to  engage  the  target  and  is  the  target  within  the  maneuver 
footprint  of  the  COPPERHEAD? 
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Test  18:  Does  the  COPPERHEAD  round  hit  the  target? 

Test  19:  Does  the  COPPERHEAD  round  kill  the  target? 

If  tests  12  through  19  are  all  passed,  then  we  have: 

Event  4:  The  target  vehicle  is  killed.  This  is  termed  a 

"kill." 

If  more  COPPERHEAD  rounds  are  to  be  fired  for  this  mission, 
the  model  time  is  moved  ahead  to  account  for  the  time  between  rounds, 
and  the  model  resumes  at  Event  3  for  the  next  COPPERHEAD  round. 

To  model  the  "random  occurrence"  1 ine-of-sight  case,  tests  4 
and  11  are  not  made  and  test  12  uses  a  different  assumption. 

The  two  ways  of  handling  the  1 ine-of-sight  problem  are 
called  the  "shooting  gallery"  method  and  the  "random  occurrence" 
method. 


The  "shooting  gallery"  method  assumes  that  the  entire 
COPPERHEAD  mission  must  be  completed  during  the  time  interval  starting 
with  the  first  target  vehicle  entering  1 i ne-of-sight  segment  and 
ending  with  the  last  vehicle  of  the  target  leaving  that  same  1 ine-of- 
sight  segment  (see  Figure  2-1). 

The  "random  occurrence"  method  on  the  other  hand  assumes 
that  target  vehicles  are  passing  in  and  out  of  view.  Instead  of 
assuming  that  all  rounds  fired  after  the  last  target  vehicle  leaves 
the  1 ine-of-sight  segment  in  which  it  was  acquired  are  wasted  as  in 
the  "shooting  gallery"  technique,  the  "random  occurrence"  method  does 
not  check  loss  of  1 i ne-of-sight  until  the  last  critical  seconds  of  the 
COPPERHEAD  trajectory  and  even  then  the  check  allows  for  the  possibility 
that  a  target  may  have  left  the  first  1 ine-of-sight  segment  but  entered  a 
second  (or  subsequent)  1 ine-of-sight  segment  where  COPPERHEAD  can  be  used. 

The  "random  occurrence"  1 ine-of-sight  model,  then  merely  checks  whether 
there  is  at  least  one  unkilled  target  vehicle  that  will  be  within  line-of- 
sight  of  the  designator  for  the  final  critical  seconds  of  the  COPPERHEAD 
trajectory  (see  Figure  2-2). 

Now  each  step  (test)  in  the  model  is  explained  in  detail: 

2.2.2  Preparatory  Fires.  The  first  test  encountered  by  a  potential 
COPPERHEAD  mission  is  for  designator  operator  survivability  of  preparatory 
fire.  A  probability  that  the  designator  operator  is  killed  by  enemy  prepar¬ 
atory  artillery  is  input  (either  explicitly  or  by  default)  and  for  each 
replication  ( i . e . ,  each  sample  potential  COPPERHEAD  mission)  of  the  given 
case,  a  uniformly  distributed  (pseudo-)  random  number  is  drawn.  If  that 
random  number  is  less  than  the  input  probability  that  the  designator  operator 
is  killed  by  enemy  preparatory  artillery  fire,  then  the  potential  COPPERHEAD 
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FIGURE  2-1  "Shooting  Gallery"  LOS  Model 
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FIGURE  2-2  "Random  Occurrence"  LOS  Model 


mission  aborts  because  the  designator  operator  is  killed;  otherwise,  the 
potential  COPPERHEAD  mission  continues  to  the  next  test. 


2.2.3  Visibil ity  Range.  The  next  test  depends  on  the  weather 
conditions.  For  the  month  and  time  of  day  that  is  used  for  a  given  case, 
there  is  a  distribution  of  weather  conditions  which  includes  the  probabilities 
of  various  cloud  ceiling  altitude  and  meteorological  visibility  range 
combinations  as  well  as  probabilities  of  various  Pa squ ill  atmospheric 
stability  categories,  windspeeds,  and  relative  humidities.  For  each  repli¬ 
cation  of  a  given  case,  the  cloud  ceiling  altitude  and  meteorological 
visibility  range  distribution  is  sampled  and  the  results  (cloud  ceiling 
altitude  and  meteorological  visibility  limit  (range))  obtained  are  recorded 
for  later  use. 

The  program  then  samples  the  acquisition  range  distribution  once 
for  each  replication  to  obtain  the  range  from  designator-operator  (D.O.) 
to  target  terrain  unmask  for  the  current  replication.  If  the  target 
unmasks  from  terrain  shielding  at  a  range  from  the  designator-operator 
beyond  the  current  replication's  meteorological  visibility  limit,  then 
the  potential  COPPERHEAD  mission  is  aborted  since  the  target  cannot  be 
seen  and,  therefore,  cannot  be  lased  by  the  designator  operator;  if, 
on  the  other  hand,  the  target  unmasks  at  a  range  less  than  the  visi¬ 
bility  limit,  then  the  next  test  is  made. 

2.2.4  Designator  Maximum  Range.  Using  the  above  random  sample 
from  the  acquisition  (terrain  unmask)  range  distribution,  the  next  test 
compares  the  designator-to-target  range  with  the  maximum  designator 
range.  If  the  target  is  beyond  the  maximum  designation  range,  then  the 
potential  COPPERHEAD  fire  mission  is  aborted;  otherwise,  the  tests  continue. 

At  night,  the  maximum  designator  range  is  reduced  to  the 
range  to  which  the  thermal  imagery  night  sight  is  usable  for  aiming 
the  designator. 


2.2.5  Target  Not  Detected.  The  next  test  is  performed  to  deter¬ 
mine  whether  the  target  was  in  view  long  enough  to  be  acquired  (the  entire 
detection,  recognition  identification  process  is  lumped  into  one  test  and 
called  detection). 

After  a  range  from  designator-operator  to  target  terrain  unmask 
is  obtained  as  above,  a  1 ine-of-sight  segment  length  distribution  is 
sampled  to  obtain  the  length  of  the  section  of  the  target's  path  extending 
from  the  point  of  initial  terrain  unmask  to  the  first  point  along  the  path 
that  is  obscured  from  the  D.O.'s  view.  From  this  1 i ne-of-sight  segment 
length  together  with  the  target  velocity  and  length  of  the  target  unit 
column,  the  duration  of  1 ine-of-sight  is  calculated.  This  duration  is  the 
time  from  initial  target  unmask  until  the  last  vehicle  in  the  target  unit's 
column  passes  out  of  the  D.O.'s  view. 
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To  determine  whether  the  target  is  detected,  a  time  is  sampled 
from  a  distribution  of  detection  times.  This  time  represents  the  delay 
from  the  time  of  initial  target  unmask  until  the  D.O.  has  detected,  recognized, 
and  identified  the  target  and  decided  to  call  for  COPPERHEAD  fire.  This 
is  termed  detection  time. 

If  the  detection  time  is  greater  than  the  duration  of  the  line- 
of-sight  on  a  particular  replication,  then  the  target  is  considered  to 
have  gone  in  and  then  out  of  view  before  the  D.O.  could  detect  it  (or 
really  before  he  could  call  for  fire  against  it)  and  the  mission  aborts. 

If  the  detection  time  is  less  than  the  1 i ne-of-sight  duration,  then  the 
D.O.  detects  and  calls  for  fire  on  the  target  before  it  leaves  his  line-of- 
sight  and  the  model  continues  to  the  next  test. 

2.2.6  Smoke.  The  next  test  is  to  determine  whether  there  is 
sufficient  smoke  in  the  area  of  the  target  to  prevent  the  D.O.  from  either 
seeing  or  lasing  the  target.  The  smoke  model  computes  the  fraction  of 
targets  that  could  be  obscured  from  view  by  taking  into  account  such  ^actors 
as  number  and  type  of  RED  smoke  rounds  fired  and  weather  conditions  for 

the  month  and  time  of  day  considered  in  the  current  case. 

As  an  alternative  to  specifying  a  volume  of  RED  smoke  rounds 
which  is  then  used  to  calculate  the  fraction  of  targets  obscured,  one 
can  simply  input  a  fractional  value  which  represents  the  fraction  of 
targets  obscured  by  smoke. 

In  either  case,  the  fraction  of  targets  (actually  fraction 
of  a  specified  front  width)  obscured  by  smoke  is  played  as  a  "proD- 
ability  of  abort  due  to  smoke."  For  each  replication  that  reaches  the 
smoke  test,  a  random  number  is  drawn  from  a  uniform  distribution  (from 
0  to  1)  and  if  it  is  less  than  the  probability  of  abort  due  to  smoke, 
then  the  mission  is  aborted  at  this  step;  if  it  is  greater  than  the 
probability  of  abort  due  to  smoke,  then  the  next  test  is  performed. 

Note  that  while  the  D.O.  has  a  limited  target  detection 
capability  in  smoke  by  using  a  thermal  site  on  the  designator,  the 
laser  beam  itself  could  not  penetrate  the  smoke  in  those  cases  where 
smoke  was  thick  enough  to  require  use  of  a  thermal  site.  Conse¬ 
quently,  COPE  plays  a  "black -white"  smoke  situation:  either  smoke 
completely  aborts  the  mission  or  has  no  effect.  This  is  not  the  case 
for  some  of  the  other  COPE  variants  (such  as  TAPE,  SOPE)  where  there 
are  three  possibilities:  (1)  smoke  is  not  present  and,  hence  has  no 
effect,  (2)  smoke  is  present  and  kills  mission,  (3)  smoke  is  present 
but  target  can  still  be  detected  through  thermal  site  and  target  is 
engaged  but  with  reduced  accuracy. 

2.2.7  Dust.  The  next  test  is  whether  the  dust  from  RED  HE 
artillery  fire  is  sufficient  to  prevent  the  D.O.  from  either  seeing  the 
target  or  lasing  it.  This  is  modeled  in  a  very  simplistic  way  in  the 
current  generation  of  COPE. 
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A  probability  that  dust  aborts  the  mission  is  estimated  out¬ 
side  the  COPE  program  and  then  input  for  a  given  COPE  case  (either 
explicitly  or  by  default).  Then  for  each  replication  that  reaches  the 
dust  test,  a  random  number  is  drawn  from  a  unif^m  distribution  (0  to 
1)  and  compared  to  the  probability  that  dust  aborts  the  mission.  If 
the  random  number  is  less  than  the  probability  that  dust  aborts  the 
mission,  then  the  mission  is  aborted;  otherwise,  the  next  test  is 
made. 


2.2.8  Designator  Bail-Out  (Precommo).  The  next  test  is  to 
check  whether  the  target  is  so  close  to  the  0.6.  that  in  order  to  survive 
he  would  not  engage  the  target.  The  assumption  is  that  to  avoid  being 
killed  by  direct  fire  from  potential  COPPERHEAD  targets,  the  D.O.  would 
move  to  a  new  position  whenever  the  enemy  front  line  units  closed  to  within 
a  certain  range;  in  the  case  of  an  isolated  lead  enemy  unit,  he  might 
merely  refrain  from  designating  rather  than  move,  but  in  either  case  he 
would  not  be  calling  for  COPPERHEAD  fire. 

To  perform  this  test,  the  model  compares  the  D.O. -to-target 
range  against  a  pre-set  "bail-out"  range.  If  the  D.O. -to-target  range 
is  less  than  the  bail-ouc  range,  the  mission  aborts;  otherwise,  the 
mission  proceeds  to  the  next  test. 

Note  that  this  bail-out  check  is  made  prior  to  the  D.O. 's 
call  for  COPPERHEAD  fire.  A  second  bail-out  check  (see  section  2.2.10)  is 
made  later. 

2.2.9  Commo-out  (Tests  8  and  9).  The  next  test  determines 
whether  the  D.O.  has  a  communication  link  with  the  F.D.C. 

Communication  delay  time  and  probability  of  success  (Test  8) 
can  be  played  in  any  one  of  three  ways  depending  on  the  input  option 
selected: 


(1)  A  single  response  time  distribution  is  used  together 
with  a  single  probability  of  having  a  good  communications  link.  In 
this  case,  a  number  is  randomly  sampled  from  the  response  time  dis¬ 
tribution  to  determine  the  total  delay  time  from  the  D.O.'s  call  for 
Copperhead  fire  until  the  firing  battery  is  ready  to  pull  the  lanyard 
to  fire  Copperhead.  In  addition,  a  second  random  number  is  drawn, 
this  time  from  a  uniform  (0  to  1)  distribution;  if  this  randan  number 
is  less  than  the  probability  of  having  a  good  communication  link,  then 
the  mission  proceeds  to  the  Test  9;  otherwise,  the  mission  is  aborted. 

(2)  The  second  way  of  playing  communication  delay  time  and 
probability  of  good  communication  link  is  called  the  "parameterized 
response  time”  option.  This  case  is  essentially  the  same  as  (1)  above 
except  that  the  delay  time  is  set  at  a  single  fixed  value  that  is  the 
same  for  every  replication  (as  opposed  to  sampling  a  distribution  of 
delay  times  to  obtain  a  new  delay  time  value  for  each  replication). 
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(3)  The  third  way  to  model  the  communication  delay  time  is 
to  use  a  separate  delay  time  for  each  part  of  the  process  from  the 
D.O.'s  calling  in  a  fire  mission  to  the  battery's  pulling  the  lanyard. 

Under  this  method,  a  delay  time  distribution  is  used  to  obtain  digital 
communication  times  for  D.O.  to  FDC  messages.  This  delay  time  is  a 
function  of  mission  type  and  time  of  day  (i.e.,  day  or  night). 

The  flowchart  in  Figure  2-3  gives  the  complete  picture  of  the 
time  delays  when  this  third  model  is  used. 

No  matter  which  of  the  three  ways  of  modeling  delay  times  is 
used,  either  communication  fails  and  the  mission  aborts  or  communication 
is  established  and  a  delay  time  is  added  to  the  current  time.  Finally,  if 
communication  is  established,  another  random  number  (uniform  between  0  and 
1)  is  drawn  and  compared  to  the  probability  of  a  successful  (i.e.,  one 
containing  the  correct  information)  message  (Test  9).  If  the  random  number 
is  less  than  this  probability,  the  mission  proceeds  to  the  next  test; 
otherwise,  the  mission  aborts  because  the  message  from  the  F.O.  had  bad 
data  or  was  incorrectly  interpreted. 

2.2.10  Designator  Bail-Out  After  Communication.  After  the 
communication  from  D.O.  to  FDC  to  firing  battery  is  completed  successfully, 
the  O.O.-to-target  distance  is  updated  to  account  for  target  movement 
during  the  communication  and  processing  delay.  If  the  updated  position 
brings  the  target  within  the  "bailout"  range  of  the  D.O.  (see  2.2.8)  then 
the  mission  is  aborted;  otherwise,  the  mission  continues  with  the  next 
test. 


2.2.11  Line-of-Sight  Lost  Prior  to  Firing.  The  next  test  is  to 
determine  whether  the  D.O.  has  lost  LOS  to  the  target.  The  current  time 
(detection  time  plus  communication  and  processing  delay  times)  is  compared 
to  the  duration  of  line-of-sight.  If  the  current  time  is  greater  than  the 
duration  of  line-of-sight,  then  the  target  has  left  the  D.O.'s  field  of 
view  prior  to  the  firing  of  the  first  COPPERHEAD  and  the  mission  is  aborted; 
otherwise,  the  mission  is  fired,  the  time  of  flight  is  added  to  the  current 
time,  and  the  next  test  is  made. 

2.2.12  Line-of-Sight  Lost  During  Mission.  The  tests  prior  to 
this  affected  the  entire  mission,-  the  sequence  of  tests  after  this  point 
is  performed  separately  for  each  round  in  the  fire  mission. 

The  current  time  (which  is  the  time  the  first  (next)  COPPERHEAD 
round  is  to  arrive)  is  compared  to  the  duration  of  line-of-sight.  If  the 
current  time  is  greater  than  the  duration  of  line-of-sight,  then  the  current 
round  is  aborted  (ineffective);  otherwise,  the  mission  proceeds  to  the 
next  test. 


2.2.13  Designator  Not  Warned  In  Time. 

At  the  time  the  first  COPPERHEAD  round  is  fired  for  a  given  mission,  a 
message  is  sent  to  the  D.O.  by  the  FDC  telling  him  to  begin  lasing  the 
target.  To  determine  whether  the  D.O.  receives  this  message,  a  random 
number  is  drawn  from  a  uniform  (0  to  1)  distribution  and  compared  to  the 
probability  of  D.O.  warned  to  lase.  If  the  random  number  is  less  than  the 
probability,  tnen  the  message  gets  through,  the  D.O.  lases,  and  the  next 
test  is  performed;  otherwise,  the  message  does  not  get  through,  the  D.O. 
fails  to  lase,  and  the  first  round  is  wasted  (aborted). 

Even  if  the  message  warning  the  D.O.  to  lase  does  not  get 
through  for  the  first  COPPERHEAD  round,  the  model  assumes  that  the 
D.O.  would  see  the  first  round  impact  and  hence  know  to  begin  lasing 
for  the  second  and  subsequent  rounds;  therefore,  rounds  after  the 
first  round  are  never  lost  because  of  D.O.'s  failure  to  lase. 

2.2.14  Designator  in  Direct  Fire.  The  next  test  determines 
whether  the  D.O.  is  unable  to  lase  due  to  incoming  direct  fire.  It  is 
assumed  that  the  target  being  lased  for  the  COPPERHEAD  fire  mission  has  a 
laser  alarm  as  well  as  capability  that  allows  it  to  locate  the  D.O.'s 
position  (when  his  laser  is  on)  with  sufficient  accuracy  to  fire. 

A  random  number  is  drawn  from  a  uniform  (0  to  1)  distribution 
and  compared  to  probability  of  kill  and  probability  of  suppression  values 
(which  are  a  function  of  D.O. -to-target  range).  If  the  random  number  is 
less  than  the  probability  of  kill,  then  the  D.O.  is  considered  killed  and 
the  current  round  and  all  subsequent  rounds  for  this  replication  are  aborted. 
If  the  random  number  is  greater  than  the  probability  of  kill  but  less  than 
the  sum  of  the  probability  of  kill  plus  the  probability  of  suppression 
(obscuration  due  to  direct  fire),  then  only  the  current  round  is  aborted 
as  a  result  of  this  test  (the  test  will  be  performed  separately  on  subsequent 
rounds  of  this  replication). 

If  the  random  number  is  greater  than  the  probability  of  kill  or 
suppression,  then  the  mission  continues  to  the  next  test  with  no  effect 
from  the  direct  fire. 

2.2. 15  Round  Rel iabi 1  ity  Fai lure.  The  round  is  next  tested  for 
inflight  rel iabi 1 i ty.  A  random  number  is  drawn  from  a  uniform  distribution 
(0  to  1)  and  compared  to  the  round  reliability.  If  the  random  number  is 
less  than  the  reliability,  the  round  is  reliable  and  the  next  test  is 
made;  otherwise,  the  round  fails. 

2.2.16  Target  Obscured  By  Mini-Terrain.  The  D.O. -to-target 
range  is  computed  allowing  for  target  movement  up  to  the  current  model 

time  (actual ly,  the  time  the  first  (or  next)  COPPERHEAD  round  is  to  arrive). 

A  distribution  of  target  exposures  (due  to  mini-terrain)  at  that  range  is 
then  sampled  to  determine  whether  the  target  is  fully  exposed,  hull  defilade 
(turret  exposed),  or  completely  obscured.  If  the  target  is  completely 
obscured,  then  the  round  aborts;  otherwise,  the  next  test  is  made. 


2.2.17  Round  Did  Not  Engage  Target.  The  next  test  determines 
whether  the  COPPERHEAD  round  receives  sufficient  reflected  laser  energy  to 
initiate  maneuver  to  a  target  and  has  the  target  in  its  maneuver  footprint. 

To  perform  this  test,  a  random  number  is  drawn  from  a  uniform  (0 
to  1)  distribution  and  then  compared  to  a  probability  of  seeker  engagement 
value  which  is  a  function  of  designator-to-target  range,  visibility  range 
limit,  cloud  ceiling  altitude,  delay  time,  and  number  of  vehicles  in  column 
as  well  as  reflectivity  of  target,  seeker  sensitivity,  target  heading, 
target  velocity,  nominal  COPPERHEAD  system  response  time,  gun-target-D.O. 
angle,  designator  type,  and  deflection  biases  (offsets).  The  probability 
of  seeker  engagement  is  the  probability  that  both  the  seeker  receives 
sufficient  reflected  laser  energy  to  initiate  tracking  and  the  target  is 
within  the  maneuver  footprint  of  the  COPPERHEAD  round.  If  the  randan 
number  is  less  than  the  probability  of  seeker  engagement,  then  the  next 
test  is  performed;  otherwise,  the  round  fails  because  its  seeker  cannot 
engage  the  target  (or  can  engage  but  cannot  maneuver  to  the  target). 

2.2.18  Round  Engaged  But  Did  Not  Hit.  A  probability  that  the 
round  hits  the  target  given  that  it  engages  (i.e.,  passes  the  previous 
test)  is  obtained  as  a  function  of  range,  exposure  (fully  exposed  or  hull 
defilade),  and  designator  type.  A  table  of  these  probabil ities  is  obtained 

as  output  from  the  LDWSS  program  and  is  intended  to  account  for  the  possibility 
that  the  COPPERHEAD  seeker  tracks  laser  over-spill  or  under-spill  rather 
than  the  target  itself. 

Again  a  uniform  distribution  (0  to  1)  is  randomly  sampled. 

If  the  resulting  random  number  is  less  than  the  probability  that  the 
round  hits,  then  the  round  hits  the  target  and  we  proceed  to  the  next 
test;  otherwise,  the  round  misses  and  aborts. 

2.2.19  Round  Hit  But  Did  Not  Kill.  The  final  test  is  to  determine 
whether  the  round  killed  the  target  given  that  it  hit  the  target.  To 
perform  this  test,  a  random  number  is  drawn  from  a  uniform  distribution  (0 

to  1)  and  compared  to  a  probability  of  kill  given  a  hit  value  which  is  a 
function  of  target  type  and  target  exposure  (fully  exposed  or  hull  defilade). 

If  the  random  number  is  less  than  the  probability  of  kill,  then  the  target 
is  killed;  otherwise,  the  target  is  not  killed  and  the  round  aborts. 

2.2.20  Subsequent  Rounds.  When  a  round  (not  a  mission)  aborts, 
subsequent  tests  in  the  sequence  are  not  made.  Instead,  the  time  is  advanced 
to  the  next  round's  arrival  time  (if  there  are  more  rounds  left  to  be 
considered)  and  the  sequence  of  tests  resumes  at  the  "LOS  lost  during 
mission"  (section  2.2.12)  test  for  the  next  round. 


If  a  round  does  not  abort,  but  instead  successfully  kills  a 
target,  then  the  time  is  advanced  to  the  next  round's  arrival  time  (if 
applicable)  and  the  sequence  of  tests  resumes  at  the  "LOS  lost  during 
mission"  (section  2.2.12)  test  for  the  next  round. 


When  no  more  rounds  remain  to  be  fired  for  a  given  repli¬ 
cation,  the  replication  is  ended. 

2.2.21  End  of  Replication.  When  either  a  mission  (not  a  round) 
aborts  or  all  the  rounds  for  a  replication  have  been  fired,  the  replication 
is  considered  ended.  If  more  replications  remain  to  be  made,  the  next 
replication  begins  with  the  first  test,  "Preparatory  fires"  (section  2.2.2) 
and  proceeds  through  the  sequence  of  tests  as  described.  If  all  replications 
for  the  current  case  are  done,  then  the  results  are  printed  out  and  the 
subsequent  case  (if  any)  is  begun. 

2.2.22  Random  Occurrence  LOS  Model  vs  Shooting  Gallery  LOS 
Mode  1 .  The  step  by  step  description  given  above  of  the  various  tests  that 
must  be  passed  for  a  successful  COPPERHEAD  fire  mission  applies  to  the 
"Shooting  Callery"  or  single  continuous  LOS  segment  model.  This  model 
assumes  that  the  entire  COPPERHEAD  mission  must  be  completed  during  the 
time  interval  from  the  first  target  vehicle's  breaking  terrain  mask  until 
the  last  target  vehicle  leaves  that  same  LOS  segment. 

The  alternate  LOS  model  is  called  the  "Random  Occurrence" 

LOS  model  and  assumes  that  after  the  first  target  vehicle  breaks  terrain 
mask,  the  target  vehicles  will  go  in  and  out  of  mask  at  random.  The  sequence 
of  tests  for  the  random  occurrence  method  is  the  same  as  for  the  shooting 
gallery  except  that  tests  4  and  11  (sections  2.2.5  and  2.2.11)  are  omitted 
and  test  12  is  modified. 

Test  12  (section  2.2.12)  is  modified  so  that  the  probability 
that  at  least  one  target  vehicle  is  visible  is  given  by  Q  =  1  -  (1  -  P)N 
where  P  is  the  probability  of  a  single  vehicle  being  visible  if  randomly 
placed  along  an  approach  path  at  the  current  D.O. -to-target  range  and  N  is 
the  number  of  vehicles  left  unkilled  in  the  target.  A  random  number  is 
sampled  from  a  uniform  distribution  (0  to  1)  and  compared  to  Q.  If  the 
random  number  is  greater  than  Q,  the  round  is  aborted;  otherwise,  the 
mission  continues  with  test  13. 


2.2.23  Note  on  Nominal  Response  Time.  The  probability  of 
engagement  numbers  are  a  function  of  the  time  after  the  D.O.'s  call  for 
fire  that  the  rounds  arrive.  The  time  is  played  by  establishing  a  nominal 
response  time  tr  (an  average  value  for  the  distribution  of  total  mission 
communication  and  processing  times  i/hich  is  input  and  to  which  is  added  the 
time  of  flight  appropriate  for  the  given  gun-to-target  range. )  The  model 
assumes  that  the  D.O.  estimates  the  target's  location  at  tr  seconds  in  the 
future  and  calls  for  fire  against  that  point.  The  actual  COPPERHEAD  mission 
response  time  is  sampled  and  added  to  the  time  of  flight  to  obtain  the 
actual  arrival  time  of  the  round  (ta).  If  ta  is  greater  than  tr,  then  the 
probability  of  engagement  is  lowered  because  of  the  larger  aiming  error  and 
TLE. 


This  is  explained  in  greater  detail  in  the  report  on  the  PAM 
model.  The  report  on  modeling  target  location  error  (TLE)  discusses  the 
problem  of  estimating  target  location  and  the  error  in  the  estimate  as  a 
function  of  time  (see  bibl iography). 

The  only  point  important  to  the  user  at_this  stage  is  that  COPE 
uses  two  response  times:  a  nominal  response  time  tr  and  an  actual  response 
time  ta.  The  nominal  response  time  is  used  to  estimate  target's  future 
location  and  hence  to  choose  the  point  at  which  to  aim.  The  actual  response 
time  is  used  to  determine  the  probability  of  seeker  engagement  (PE). 
Naturally,  if  ta  is  very  large,  the  probability  of  the  target  being  at  the 
point  estimated  (based  on  tr)  is  quite  small. 

Also,  it  was  assumed  that  if  the  firing  battery  saw  that  ta  was 
likely  to  be  less  than  tr  on  a  particular  occasion,  it  would  hold  up  firing 
to  cause  ta  =  tr  rather  than  drop  early  rounds  far  in  front  of  the  target. 
This  assumes  a  good  communication  capability  between  D.O.  and  battery. 
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3.  PERFORMANCE  AND  LIMITATIONS 

3.1  Computer  Related  Performance  and  Limitations. 

The  COPE  program  (and  its  preprocessor  programs)  has  been 
run  primarily  on  the  U.S.  Army  Ballistic  Research  Laboratory's  Control 
Data  Corporation  CYBER  76  computer  (CDC  7G00).  On  that  computer,  a 
typical  case  with  10,000  replications  and  six  rounds  fired  per  suc¬ 
cessful  COPPERHEAD  mission  requires  2.5  to  3.0  seconds  per  case.  The 
computer  memory  requirement  is  about  24,000  words  (57  Kg)  of  SCM  and 
no  LCM.  The  d i s *'  space  required  (which  will  vary  with  the  size  of  the 
data  base  file)  for  TAPE  11  was  about  155,000  words  (456  Kg). 

COPE  has  also  been  run  on  a  CDC  6600  at  Aberdeen  Proving 
Ground  and  on  a  CDC  6400  and  a  CDC  6500  at  FT.  Leavenworth  (using  the 
remote  terminal  at  FT.  Sill).  On  these  machines,  the  run  time  ranged 
from  eight  to  sixteen  times  what  it  was  on  the  CDC  7600.  The  memory 
requirements  and  disk  space  on  the  various  CDC  6000  series  computers 
were  nearly  the  same  as  for  the  CDC  7600. 

At  the  time  of  this  writing,  COPE  has  not  been  run  on  any 
non-CDC  machines;  however,  chapter  13  of  this  manual  considers  some  of 
the  changes  required  to  do  so.  Run  time  would,  of  course,  vary  from 
machine  to  machine  (e.g.  ,  the  author’s  experience  with  other  FORTRAN 
programs  suggests  run  time  on  the  UNIVAC  1108  computer  would  be  eight 
to  ten  times  that  on  the  CDC  7600). 

Most  current  non-CDC  computers  use  a  word  size  of  fewer  than 
60  bits  (the  CDC  word  size).  This  means  that  the  program  memory 
required  to  load  the  object  program  on  most  no.i-CDC  machines  will  be 
somewhat  larger  in  terms  of  number  of  words  than  for  the  CDC 
computers.  Similarly,  a  slight  increase  in  disk  space  may  be  required 
to  put  the  data  base  file  TAPE  11  on  a  smaller  word  machine. 

3.2  Program  Related  Performance  and  Limitations. 

The  current  version  of  COPE  has  been  run  several  hundred 
times  now  with  no  errors  detected  other  than  those  resulting  from 
invalid  input,  insufficient  run  time  requested,  or  insufficient  print 
limit  set. 


The  ability  of  the  program  to  run  multiple  cases  with  rel¬ 
atively  small  streams  of  input  directives  has  enabled  the  users  to  run 
hundreds  of  cases  with  relatively  short  set  up  time. 

The  main  limitation  encountered  in  running  the  program  is 
the  requirement  that  data  selected  to  fill  the  eight  data  blocks  be  on 
the  random  access  mass  storaye  data  base  file  created  by  the  preprocessor 
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programs.  Once  these  preprocessors  are  run,  any  case  using  data  already 
on  the  data  base  file  can  be  easily  run.  This  subject  is  discussed  in 
detail  in  chapter  5. 


3.3  Model  Related  Performance  and  Limitations. 

One  of  the  main  limitations  of  the  COPE  model  is  that  much 
tactical  detail  is  represented  by  distributions.  For  this  reason,  great 
care  must  be  taken  to  interpret  input  distributions  when  reporting  model 
results.  The  interpretation  of  results  depends  heavily  on  the  conservatism 
and  objectivity  of  the  analyst. 

The  only  attempt  (and  indeed  the  only  opportunity)  to  verify 
the  COPE  model  was  by  running  it  with  case  descriptors  matching  as 
closely  as  possible  conditions  present  in  the  COPPERHEAD  OT  II.  When 
this  was  done,  the  results  predicted  by  COPE  were  compared  to  those 
obtained  in  OT  II  and  found  to  be  in  quite  close  agreement.  More  pre¬ 
cisely,  the  hypothesis  that  the  probability  of  hit  given  a  shot  as 
obtained  from  COPE  is  equal  to  the  true  population  probability  of  hit 
given  a  shot  could  not  be  rejected  even  with  a  significance  level  as 
high  as  50  percent  based  on  the  sample  of  firings  in  OT  II. 

This  good  agreement  of  the  model  to  test  results  should  not 
lead  to  uncritical  acceptance  of  all  COPE  results.  For  one  thing, 
tests  1,  5,  6,  and  14  were  nulled  out  (that  is,  always  passed).  Also, 
since  the  OT  II  rounds  were  not  live,  the  probability  of  kill  values 
(test  19)  in  the  model  were  set  to  one  (so  that  kl’ls  and  hits  were 
considered  equivalent). 

There  are  some  limitations  to  the  COPE  model  that  need  to  be 
explicitly  pointed  out: 

3.3.1  Geometry  of  COPPERHEAD  Fire  Mission.  The  geometry  of  the 
gun,  0.0.  ,  and  target  positions  is  only  approximated.  For  any  given 
simulated  COPPERHEAD  mission,  the  gun-to-target  range,  designator-to-target 
point-of-unmask  range,  target  heading,  and  nominal  gun-target-desi gnator 
angle  are  fixed  while  the  target  itself  moves  ( i . e. ,  its  position  is  a 
function  of  time). 

Figure  3-1  represents  the  geometry  of  a  COPPERHEAD  fire  mission. 

U  is  the  point  of  target  unmask. 

R  is  the  point  at  which  round  is  to  arrive  on  target  (provided 
nominal  response  time  is  met). 


D  is  the  designator  operator  location. 
G  is  the  gun  location. 


IH  is  the  target  heading  (angle  between  gun-target  line  and  target 
path  at  time  round  arrives  on  target). 

n  is  the  angle  between  the  gun-to-target  line  (GR)  and  the 
designator-to-target  line  (DR). 

UR  is  the  target's  path  (target  travels  from  U  to  R). 

By  the  COPE  c^se  conditions  chosen,  iT,  tH,  the  length  of 
GR,  and  the  length  of  UD  are  constant  (the  first  three  are  constant 
for  a  given  case;  the  last,  length  of  UD,  is  constant  for  a  given 
replication,  but  is  sampled  anew  for  each  repl ication).  Hence,  if  the 
response  time  is  such  that  the  target  is  at  R'  on  one  replication 
rather  than  at  R  (as  on,  say,  a  previous  replication)  when  the  round 
arrives,  one  must  move  G  to  GJ_,  and  D  to  D’  to  preserve  the  fixed 
values  of  *T,  fcH,  length  of  GR  (now  G‘R'). 

The  requirement  that  G  move  to  G'  is,  of  course,  unrealistic 
since  one  does  not  move  the  battery  to  a  new  site  just  because  nominal 
response  time  is  not  met. 

A  second  compromise  in  the  geometric  representation  of  the 
COPPERHEAD  mission  is  in  calculating  the  desi gnator-to-target  range.  Rather 
than  compute  the  designator-to-target  range  DR  (or  DR'  in  the  second  case) 
in  the  correct  manner,_the  COPE  model  approximates  the  designator-to-target 
range  by  the  distance  PD.  Pisa  point  chosen  on  UD  such  that  UP  =  UR  (or 
P‘  such  that  UP'  =  UR'  in  the  second  case).  This  approximation  is  equivalent 
to  the  assumption  that  the  target  moves  straight  toward  the  designator. 

One  can  see  from  the  lj_ne  segment  lengths  in  Fi gure  3-1  that 
PD  does  not  differ  greatly  from  RD  (in  this  case)  whereas  P 1 D  does  differ 
considerably  from  R rD  in  length.  For  typical  range  values  and  velocities 
used  so  far  in  COPE,  these  errors  are  considered  minor.  If  one  is  to  use 
greater  target  velocities  or  shorter  acquisition  ranges,  then  it  would  be 
worthwhile  to  improve  this  feature  of  COPE.  _[That  is^  incorporate  the 
trigonometry  required  to  correctly  calculate  DR  (or  DR')  and  use  that  value 
instead  of  PD  (or  DP'). 

Note:  The  designator  operator-to-target  distance  is  used  not 
only  at  round  arrival  to  calculate  probability  of  engagement  and 
probability  of  hit;  but  also  throughout  the  simulation  it  is  updated 
and  used  in  checking  bail-outs,  direct  fire  suppression,  1 ine-of-sight 
probability  for  random  occurrence,  etc. 

3.3.2  Target  Modeling.  The  COPE  model  makes  simplifying 
assumptions  about  the  target.  In  particular,  it  assumes  that  the 
target  is  a  column  of  vehicles  moving  at  constant  velocity  with 
uniform  spacing  between  successive  vehicles.  When  a  vehicle  is 
killed,  the  length  of  the  column  is  not  reduced  in  length  nor  is  any 
attempt  made  to  keep  a  record  of  the  position  that  the  killed  vehicle 
occupied  in  the  column. 


These  limitations  were  not  deemed  serious  in  the  COPE  runs 
for  the  COPPERHEAD  COEA;  however,  for  the  SADARM  variant  of  COPE  (called 
SOPE)  the  model  was  modified  to  keep  track  of  individual  vehicle  status 
and  to  handle  more  general  target  layouts.  (These  modifications  were 
essential  to  SADARM  where  there  is  no  designator  operator  to  pick  out  live 
targets  instead  of  dead  ones,  and  where  the  volley  attacks  an  area  instead 
of  a  point  as  with  a  single  COPPERHEAD  round). 

3.3.3  Direct  Fire  Effects  Independent.  The  model  of  direct 
fire  effects  of  the  target  against  the  D.O.  (see  section  2.2.14)  is  over¬ 
simplified.  The  model  has  a  single  probability  of  kill  (or  obscuration) 

by  direct  fire  for  each  target-to-D.O.  range  and  this  probability  (corrected 
for  then  current  range)  is  then  applied  during  each  COPPERHEAD  round's 
firing  to  determine  whether  the  D.O.  is  killed  (or  obscured)  and  thus 
prevented  from  lasing. 

The  shortcomings  of  this  model  are  (1)  subsequent  rounds  fired 
by  the  target  at  the  D.O.  should  be  more  accurate  both  due  to  adjustment 
(assuming  both  that  the  D.O.  survived  previous  rounds  fired  by  the  target 
and  that  the  target  survived  previous  COPPERHEAD'S)  by  the  target  after 
seeing  its  first  round  impact  and  due  to  the  D.O. 's  giving  away  his  position 
more  times  by  the  additional  lasings,  and  (2)  adjacent  vehicles  in  the 
target  unit,  after  seeing  the  lasings  for  the  first  few  rounds,  might  join 
in  firing  at  the  D.O.  on  the  latter  rounds.  Both  effects  (1)  and  (2)  are 
omitted  in  COPE's  model  of  direct  fire  against  the  D.O.. 

3.3.4  Only  Initial  Acquisitions  (Unmaskinqs)  Played.  The  COPE 
model  only  plays  the  first  unmasking  of  each  target  unit.  A  more  realistic 
assessment  of  COPPERHEAD'S  contribution  would  be  obtained  if  the  target 

unit  were  acquired  (or,  at  least,  unmasked  to  provide  a  potential  acquisition) 
several  times  as  it  closes  toward  the  BLUE  position.  This  would  require 
keeping  track  of  the  damage  done  to  the  RED  target  unit  as  the  result  of 
previous  unmaskings  (  and  the  resulting  COPPERHEAD  fire  missions)  so  as 
not  to  take  credit  for  killing  vehicles  many  times  over.  It  would  be  a 
fairly  straight  forward  task  to  modify  the  COPE  program  to  allow  for  multiple 
acquisitions  (and  firing)  of  each  target  unit.  The  reason  this  was  not 
done  in  the  original  COPE  model  is  simply  that  all  of  the  acquisition  data 
(range  to  unmask  and  1 ine-of-sight  segment  lengths)  available  to  the  model's 
creators  were  for  first  acquisition  only. 

3.3.5  Other  Limitations.  Other  limitations  to  COPE  are 
chiefly  due  to  either  inadequate  data  or  to  the  desire  to  keep  the  model 
and  program  simple.  These  limitations  include: 

(a)  Availability  of  artillery  to  fire  the  COPPERHEAD  mission 
is  not  considered. 

(b)  The  impact  of  the  attrition  of  a  D.O.  or  an  F.O.  (forward 
observer)  on  the  ability  of  the  direct  support  artillery  to  perform  its  mission 
is  not  considered.  That  is,  how  much  of  the  lost  D.O.  capability  could  be 
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picked  up  by  neighboring  0.0. ‘s,  other  Fire  Support  Team  (FIST)  members, 
or  platoon  F.O. 's? 


(c)  The  permanent  loss  of  communications  is  not  played.  This 
could  be  partially  simulated  by  reducing  the  probability  of  a  successful 
transmission,  although  that  value  was  intended  to  represent  only  degradation 
due  to  high  communication  traffic  load  and  electronic  warfare. 


! 

i 


CHAPTER  4 


4.  INPUT  DIRECTIVES  AND  "DATA"  STATEMENTS 

4.1  Input. 

Considerable  effort  has  gone  into  making  the  COPE  input 
versatile  enough  to  allow  for  the  running  of  nearly  any  combination  of 
input  parameters  while  at  the  same  time  requiring  a  minimum  of  input 
changes  to  switch  from  one  case  to  another.  The  stacking  of  multiple 
cases  for  a  single  ’'un  can  be  easily  accomplished  with  relatively  few 
input  cards. 

The  existence  of  "default"  (baseline  case)  values  built  into 
the  program  allows  the  program  to  be  run  with  only  the  input  cards  (or 
card  images)  required  to  change  those  variables  which  it  is  desired  to 
set  at  other  than  the  default  values.  If  further  cases  are  desired 
one  can  continue  with  additional  input  changes  applied  to  either  the 
previous  case  or  the  baseline  case. 

The  program  also  allows  the  insertion  of  up  to  three  types 
of  user  comments  which  may  appear  in  the  output. 

Finally,  in  the  event  that  one  washes  to  use  data  not  in  the 
"data  base"  file,  a  "temporary"  option  using  traditional  formatted 
data  is  available. 

4.2  Data  Organization. 

For  each  case  that  is  run,  there  are  numerous  parameters 
whose  values  .re  set  to  provide  the  mathematical  description  of  that 
case.  These  parameters  are  grouped  into  eight  major  blocks,  sir 
condition  keys,  and  twenty  odd  individually  selected  numerically 
valued  variables. 

For  the  most  part,  a  single  input  card  is  used  to  select 
each  block,  key,  or  variable  value.  There  are  some  exceptions  and 
some  dependencies  between  choices  which  are  explained  below  (section  4.8). 

Finally,  there  are  numerous  data  items  whose  values  are  set 
in  the  Block  Data  (BDATA1)  subprogram  because  they  are  relatively 
fixed  from  case  to  case.  Obviously,  if  one  chose  to  vary  these  items 
frequently,  they  could  be  made  into  input  rather  than  set  via  data 
statements.  These  items  are  defined  below  (section  4.7) 

4.3  Keyword  input:  General  Description. 

Each  input  to  select  a  case  description  (except  when  the 
"temporary"  option  is  used)  as  well  as  various  inputs  to  control 
program  options  is  of  the  form: 
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keyword,  option  word  1,  option  word  2,  ,  option  word  n 

where  0  <  n  <  9.  Each  such  input  must  be  contained  on  one  card  (or  card 
image);  no  continuation  to  another  card  is  allowed. 

The  keyword  is  an  alphanumeric  character  string  indicating 
which  case  descriptor  is  to  be  set  by  the  card. 

The  option  words  are  either  alphanumeric  character  strings 
that  indicates  which  option  is  chosen  from  a  pre-defined  set  or 
numerical  values  that  are  to  he  used  for  certain  variables. 

Option  words  are  order  dependent  (i.e.,  keyword,  x,  y  is  not 
equivalent  to  keyword,  y,  x).  If  an  option  word  is  omitted,  a  default 
value  is  set  by  the  program.  If  a  keyword  takes  two  or  more  option- 
words  and  an  option  word  other  than  the  last  one  is  omitted,  then  the 
proper  number  of  separators  (commas,  for  example)  must  be  used  to 
position  the  later  optionwords  (e.g., 

keyword,  default  value  for  option  word  1,  option  word  2 

is  equivalent  to 

keyword,  ,  option  word  2 

but  not  equivalent  to 

keyword,  option  word  2 _ 

In  most  cases,  blanks  may  be  freely  inserted  withi n  keywords 
or  option  words  to  improve  readability.  (The  only  exception  is  covered 
in  the  note  of  section  4.5.3.). 

4,4  Keyword  Input:  Specifics. 

Now  each  keyword  is  shown  with  the  option  words  allowed. 

Note  that  new  option  words  may  be  introduced  by  running  the  PREPMS 
pre-processor  program  to  modify  the  data  base  file  (section  5.3.8  and 
chapter  14). 

4.4.1  FIRST  CASE. 

(a)  general  form;  FIRST  CASE 

(b)  This  card  is  used  only  as  the  first  non-comment  card  in 
an  input  deck.  If  it  is  omitted,  the  program  will  generate 
a  message  upon  encountering  the  first  non-comment  card  in 
the  input  and  then  proceed  as  though  the  FIRST  CASE  card 
were  present. 


4.4.2  NEXT  CASE. 


(a)  general  form:  NEXT  CASE,  option  word  1 

(b)  Currently  allowed  character  strings  for  option  word  1 
are: 

(1)  RESET  DEFAULTS  or  RD 

(2)  DON'T  RESET  or  DR. 

(c)  This  card  is  the  first  non-comment  card  of  each  case 
other  than  the  first  case. 

If  the  option  word  is  RESET  DEFAULTS,  RD,  or  omitted, 
then  the  values  for  all  case  description  parameters  are  reset  to  their 
default  values  and  will  differ  from  the  baseline  values  only  as  determined 
by  the  remaining  input  cards  for  the  current  case. 

If  the  option  word  is  DON'T  RESET  or  DR_,  then  the  values  of  the 
case  description  parameters  remain  at  their  values  for  the  previous  case 
except  for  those  values  changed  by  the  remaining  input  cards  for  the  current 
case. 


If  the  NEXT  CASE  card  is  omitted,  the  program  will  generate  a 
message  and  proceed  as  though  a  NEXT  CASE,  DR  card  had  been  encountered. 

Note:  The  PLOT  and  CONTROL  cards  (sections  4.4.5  and  4.4.6)  are 
not  controlled  by  the  option  on  the  NEXT  CASE  card. 

4.4.3  END. 

(a)  general  form:  END 

lb)  This  card  belongs  at  the  end  of  the  input  for  each  case 
other  than  the  final  case. 

If  it  is  omitted,  an  error  will  usually  result  because  the  program 
will  continue  reading  cards  that  are  really  part  of  the  next  case’s  input 
until  it  either  hits  an  END  card,  ENDF  card,  or  the  end  of  the  input  file. 
This  means  that  the  case  will  run  using  its  own  input  together  with  input 
from  subsequent  case  (or  cases).  The  user  can  detect  this  problem  from 
the  fact  that  the  case  descriptors  will  probably  be  incorrect  { i - e . , 
other  than  the  intended  values)  in  the  case  heading  print-out,  there  may 
be  unexpected  messages  stating  that  certain  input  cards  have  superseded 
others,  and  finally,  the  number  of  cases  in  the  run  will  be  wrong. 

4.4.4  ENDF. 

(a)  general  form:  ENDF  or  END  OF  FINAL  CASE. 
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(b)  This  card  should  be  the  final  card  of  the  final  case. 


If  it  is  omitted,  the  program  will  generate  a  message  on  reaching 
the  end  of  input  and  then  proceed  as  though  an  ENDF  had  been  encountered. 

If  an  END  card  is  used  instead,  there  will  be  no  change  in  the 
result  but  the  program  will  waste  a  few  nano-seconds  before  realizing  that 
there  is  no  more  input. 

If  an  ENDF  is  used  prior  to  the  end  of  the  last  case,  any  cards 
following  the  ENDF  card  will  be  ignored. 

4.4.5  PLOT. 

(a)  general  form:  PLOT,  option  word  1,  option  word  2 

(b)  Allowed  character  strings  for  option  word  1  are: 

(1)  PRINTER 

(2)  CALCOMP. 

Allowed  character  strings  for  option  word  2  are: 

(1)  OFF 

(2)  ON. 

(c)  This  keyword  was  designed  to  handle  graphic  output 

(bar  charts)  ,  but  has  not  been  implemented  in  the  current 
version  of  the  program. 

The  cards  PLOT,  PRINTER,  ON  and  PLOT,  CALCOMP,  ON  would  cause 
results  to  be  displayed  on  bar  graphs  produced  by  the  line  printer  and 
Cal-Comp  plotter  respecti vely.  At  the  present  time,  however,  these  cards 
will  only  cause  the  program  to  generate  a  message  saying  that  no  plot  was 
produced. 


The  cards  PLOT,  PRINTER,  OFF  and  PLOT,  CALCOMP,  OFF  turn  off  the 
production  of  the  bar  graphs  produced  by  the  line  printer  and  Cal-Comp 
plotter  respectively. 

The  default  for  option  word  1  is  PRINTER;  the  default  for  option- 
word  2  is  OFF.  So  no  bar  graphs  (or,  at  the  present  time,  "no  plot" 
messages)  are  produced  unless  positive  action  is  taken  by  the  user. 

Note,  that  if  and  when  this  feature  is  implemented,  the  two 
types  of  graphs  may  be  selected  independently  of  each  other. 


A  PLOT  option  once  selected  remains  in  effect  until  a  further 
PLOT  card  is  encountered  changing  the  option  (that  is,  ON  to  OFF  or  OFF 
to  ON).  It  is  not  affected  by  a  NEXT  CASE,  RD  card. 

4.4.6  CONTROL. 


(a)  general  form:  CONTROL,  option  word  1,  option  word  2 

(b)  Allowable  choices  for  option  word  1  are: 

(1)  ECHO 


Allowable  choices  for  option  word  2  are: 

(1)  SHORT 

(2)  LONG. 


(c)  This  keyword  is  designed  to  control  miscellaneous  pro¬ 
gram  features.  At  the  present  time,  the  only  choice  (and 
the  default)  for  option  word  1  is  ECHO.  If  option  word  2  is 
SHORT  or  omitted,  then  the  short  form  of  the  input  echoing 
is  used;  if  option  word  2  is  LONG,  the  long  form  of  the  input 
echoing  is  used  (see  section  7.6  for  input  echoing). 

The  default  (which  occurs  if  the  card  is  omitted)  is  the  short 

form. 


A  CONTROL  option  once  selected  remains  in  effect  until  a  further 
CONTROL  card  is  encountered  changing  the  option  (that  is,  LONG  to  SHORT  or 
SHORT  to  LONG).  It  is  not  affected  by  a  NEXT  CASE,  RD  card. 

4.4.7  LINE  Of  SIGHT  MODE. 


(a)  general  form:  LINE  OF  SIGHT  MODE,  option  word  1  or 
LOS  MODE,  option  word  1 

(b)  Allowable  choices  for  option  word  1: 

(1)  SHOOTING  GALLERY  or  SG 

(2)  RANDOM  OCCURRENCE  or  RO. 

(c)  The  choice  of  SHOOTING  GALLERY  or  _SG  for  option  word  1 
causes  the  current  case  to  be  run  using  the  "shooting 
gallery"  line  of  sight  model.  If  option  word  I  is  RANDOM 
OCCURRENCE  or  RO,  then  the  "random  occurrence"  line  of 
sight  model  is  used. 


The  default  is  the  "shooting  gallery"  model. 


4.4.8  MISSION  CODE 


(a)  general  form:  MISSION  CODE,  option  word  1  or 
MSNCODE,  option  word  1 

(b)  Allowable  character  strings  for  option  word  1  are: 

(1)  PRIORITY  PREPLANNED  TARGET  or  PPPT 

(2)  PREPLANNED  TARGET  or  PPT 


(3)  TARGET  OF  OPPORTUNITY  or  TOO. 

(c)  If  option  word  1  is  PRIORITY  PREPLANNED  TARGET,  PPPT, 

or  omitted,  then  the  mission  is  considered  priority  pre¬ 
planned;  if  option  word  2  is  PREPLANNED  TARGET  or  PPT , 
then  the  mission  is  considered  preplanned;  and,  if  option 
word  2  is  TARGET  OF  OPPORTUNITY  or  TOO,  then  the  mission 
is  considered  a  target  of  opportunity. 

The  mission  type  affects  the  response  time  parameters  used  (see 
section  4.4.15)  and  the  modeling  of  range  from  unmask  to  centroid  (RUMC, 
section  4.4.18).  See  section  4.8  for  side  effects  of  mission  code  choice. 

4.4. 9  NUMBER  OF  DIFFERENT  TARGET  POSTURES. 

(a)  general  form:  NUMBER  OF  DIFFERENT  TARGET  POSTURES, 
option  word  1  or  NUMDIFTGTP,  option  word  1 

(b)  Allowable  character  strings  for  option  word  1  are: 

(1)  THREE  or  3 

(2)  TWO  or  2. 

(c)  If  option  word  1  is  THREE,  3,  or  omitted,  the  target 
exposure  (mini -terrain)  model  plays  three  exposures  or  pos¬ 
tures  (fully  exposed,  hull  defilade,  and  completely  obscured). 

If  option  word  1  is  TWO  or  2,  the  target  exposure  model  plays 
two  exposures  (fully  exposed  and  hull  defilade)  with  the  completely  obscured 
divided  between  the  other  two  postures  in  proportion  to  their  relative 
fractions. 


The  default  option  word  1  is  THREE. 

4.4.10  TARGET  TYPE. 

(a)  general  form:  TARGET  TYPE,  option  word  1 

(b)  Allowable  character  strings  for  option  word  1  are: 
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(1)  I 

(2)  2 

(3)  3  I 

(4)  4 

(5)  5 

(6)  6 
(7)  Z 

(c)  If  option  word  1  is  i,  then  the  vulnerabil i ty  values 

(probability  of  kill  given  a  hit  as  a  function  of  target 
exposure)  for  target  type  i  are  used. 

The  default  target  type  is  1. 

4.4.11  DESIGNATOR  TYPE. 

(a)  general  form:  DESIGNATOR  TYPE,  option  word  1  or 
DESIGTYPE ,  option  word  1 

(b)  Allowable  choices  for  option  word  1  are: 

(1)  GLLD  or  G 

(2)  MULE  or  M 

(3)  LTD  or  L 

(c)  If  option  word  1  is  GLLD ,  G,  or  omitted,  the  desig¬ 
nator  type  is  the  GLLD;  if  option  word  1  is  MULE  or  M,  the 
designator  type  is  the  MULE;  and,  if  option  word  1  is  LTD  or 
L.,  the  designator  type  is  the  LTD. 

The  default  designator  type  is  GLLD. 

See  section  4.3  for  side  effects  of  Designator  Type  Choice. 

4.4.12  DO  POSITION, 

(a)  general  form:  DO  POSITION,  option  word  1 

(b)  Allowable  choices  for  option  word  2  are: 

(1)  VANTAGE  POINT  or  VP 

(2)  MANEUVER  UNIT  or  MU. 
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(c)  If  option  word  1  is  VANTAGE  POINT,  VP,  or  omitted,  then 
the  target  posture  table  gives  breakdown  into  target 
exposure  as  seen  from  a  vantage  point. 

If  option  word  1  is  MANEUVER  UNIT  or  MU,  then  a  target  posture 
table  is  used  which  gives  the  breakdown  into  target  exposures  as  seen  from 
a  position  down  with  the  maneuver  units. 

The  default  for  DO  POSITION  is  VP. 

4.4.13  WEATHER. 

(a)  general  form:  WEATHER,  option  word  1,  option  word  2  or 
W,  option  word  1,  option  word  2 

(b)  Allowable  choices  for  option  word  1  are: 

(1)  JUNE  or  J 

(2)  DECEMBER  or  D 

(3)  MARCH  or  M 

(4)  SEPTEMBER  or  S 

Allowable  choices  for  option  word  2  are: 

(1)  1400  or  14 

(2)  0600  or  06 

(3)  2200  or  22. 

(c)  The  weather  data  used  in  COPE  is  grouped  into  sets 

of  data;  each  set  corresponding  to  a  certain  month  and 
time-of-day  combination. 

The  choice  for  option  word  1  determines  the  month  whose  weather 
data  are  to  be  used  for  the  current  case. 

The  choice  for  option  word  2  determines  the  time-of-day  whose 
weather  data  are  to  be  used  for  the  current  case. 

The  defaults  are  JUNE  or  J  for  option  word  1  and  1400  or  1_4  for 
option  word  2. 

See  section  4.8  for  side  effects  of  weather  choice. 


4.4.14  ACQUISITION  RANGE  DISTRIBUTION. 

(a)  general  form:  ACQUISITION  RANGE  DISTRIBUTION,  option 
word  1  or  ACQRNGDIST,  option  word  1 


(b)  Allowable  choices  for  optionword  1  are: 

(1)  AVERAGE  or  A 

(2)  CLOSE  or  C 

(3)  OPEN  or  0. 

(c)  If  option  word  1  is  AVERAGE,  A,  or  omitted,  then  the 
acquisition  range  and  line-of-sight  segment  length  distri¬ 
butions  used  are  those  for  TETAM  "average"  terrain.  If 
option  word  1  is  CLOSE  or  C,  then  distributions  for  TETAM 
"close"  terrain  are  used.  If  option  word  1  is  OPEN  or  0, 
then  distributions  for  TETAM  "open"  terrain  are  used. 

The  default  is  to  use  TETAM  "average"  terrain. 

See  section  4.3  for  side  effects  of  acquisition  data  choice. 

4.4.15  RESPONSE  TIME. 

(a)  general  form:  RESPONSE  TIME,  option  word  1,  option  word 

2,  option  word  3,~or  RESPTlME,  option  word!,  option  word  2, 
or  option  word  3~ 

(b)  Allowable  choices  for  option  word  1  are: 

(1)  FTSILL  or  FS 

(2)  STAUCH  or  S 

(3)  SCUNGIO 

(4)  PAR AM 

Allowable  choices  for  option  word  2  are: 

(1)  DIGITAL  or  D 

(2)  VOICE  or  V 

(3)  a  positive  numerical"  val ue  (which  represents  re¬ 
sponse  time  in  seconds). 

Allowable  choices  for  option  word  3  are: 

(1)  DAY  or  D 

(2)  NIGHT  or  N. 
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(c)  If  option  word  1  is  FT  SILL,  FS ,  or  omitted,  then  the 

response  time  distribution  supplied  by  USAFAS  at  FT  Sill  is 
used.  This  plays  the  first  way  of  modeling  delay  time  as 
described  in  Section  2.2.9. 

If  option  word  1  is  STAUCH  or  the  response  time  numbers  are 
obtained  from  the  BCS  DT  II  for  some  processes  and  TACFIRE  tests  for  others. 
These  data  were  supplied  by  Ed  Stauch  of  AMSAA  and  use  the  third  way  of 
modeling  delay  time  as  described  in  Section  2.2.9. 

If  option  word  1  is  SCUNGIO,  then  the  response  time  distribution 
used  is  a  hypothetical  distribution  created  by  Richard  Scungio  of  AMSAA  to 
test  the  sensitivity  of  COPPERHEAD  performance  to  longer  response  time. 

In  this  case  the  third  modeling  of  response  time  (see  Section  2.2.9)  is 
used. 

If  option  word  1  is  PARAM,  then  the  second  way  of  modeling  response 
time  delay  (see  Section  2.2.9)  is  employed  (so-called  "parameterized1' 
response  time).  In  this  case,  the  response  time  is  a  constant  equal  to 
the  positive  numerical  value  used  as  option  word  2. 

If  option  word  2  is  DIGITAL ,  D,  or  omitted,  then  digital  communication 
is  used  (with  voice  back-up  when  using  the  third  way  of  modeling  in  Section 
2.2.9). 

If  option  word  2  is  VOICE  or  V_,  then  voice  communication  is  used 
(this  will  have  an  affect  only  when  used  with  the  third  way  of  modeling  in 
Section  2.2.9) 

If  option  word  2  is  a  positive  numerical  value,  then  this  value 
is  used  as  the  "parameterized"  response  time.  This  can  only  be  used  with 
the  PARAM  choice  for  option  word  1.  A  zero  or  blank  option  word  2  value 
used  with  PARAM  as  option  word  1  will  cause  the  program  to  stop  (see  section 
7.5.18). 

(Note:  If  one  really  wishes  to  run  a  zero  parameterized  response 
time  value,  a  value  of  .001  could  he  used.  The  difference  between  these 
results  and  those  obtained  with  a  true  zero  response  time  would  be  far 
below  the  noise  in  the  model). 

If  option  word  3  is  DAY ,  I),  or  omitted,  day  time  response  times 
are  used.  If  option  word  3  i s  N'lGHT  or  then  nighttime  response  times  are 
used.  In  addition,  the  choice  of  day  or  night  influences  the  target  velocity 
and  maximum  designator  range  (see  Sections  4.4.21  and  4.4.22). 

The  defaults  are:  for  option  word  1,  FTSILL;  for  option  word  2, 
DIGITAL;  for  option  word  3,  DAY. 

See  section  4.8  for  side  effects  of  response  time  data  choice. 
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4.4.16  DIRECT  FIRE  SUPPRESSION. 

(a)  general  form:  DIRECT  FIRE  SUPPRESSION,  option  word  1 
or  DFIRESUPPR,  option  word  1 

(b)  Allowable  choices  for  option  word  1  are: 

(1)  HIGH  or  H 

(2)  NONE  or  N 

(c)  If  option  word  1  is  HIGH,  H  or  omitted,  then  the  direct  fire 
suppression  (obscuration  from  direct  fire)  and  kill  table 
used  is  for  a  high  level  of  D.O.  suppression  and  kill  (corre¬ 
sponding  to  tank  fire  at  the  D.O.) 

If  option  word  2  is  NONE  or  N,  then  there  is  no  effect  of  direct 
fire  on  the  0.0.. 

The  default  i s  HIGH. 

4.4.17  INVARIANT. 

(a)  general  form:  INVARIANT,  option  word  1 

(b)  Allowable  choices  for  option  word  1: 
none 

(c)  The  only  currently  allowed  choice  for  invariant  data  is 
the  default.  Provision  for  other  choices  is  built  into  the 
program  for  possible  future  use  and  may  be  activated  by  ap¬ 
propriate  preprocessor  run(s). 

4.4.18  RUMC. 

(a)  general  form:  RUMC,  option  word  1 

(b)  Allowable  choices  for  option  word  1  are: 

(1)  NO  or  N 

(2)  a  numerical  value. 

(c)  The  RUMC  (which  stands  for  range  from  unmask  to  centroid) 
value  is  the  distance  from  the  point  at  which  the  target 
breaks  terrain  mask  to  the  centroid  of  the  COPPERHEAD 
footprint. 


If  option  word  1  is  NO,  N  or  omitted,  then  RUMC  is  assumed  to 
vary  with  each  -eplication  in  such  a  way  that  the  centroid  of  the  footprint 
is  set  at  the  predicted  target  (first  vehicle)  location  for  first  round 
arrival.  This  predicted  location  is  based  on  the  nominal  (estimated)  re¬ 
sponse  time  (including  time-of-fl ight)  and  the  target  velocity. 

If  option  word  lisa  numerical  value,  then  RUMC  remains  at  that 
value  for  each  replication. 

The  RUMC  keyword  has  an  effect  only  when  the  MISSION  CODE  is 
PPPT  or  PPT  (see  Section  4.4.8).  If  the  MISSION  CODE  is  TOO,  then  the 
program  behaves  as  though  option  word  1  were  NO  regardless  of  what  may  be 

input  on  a  RUMC  card.  j 

The  default  for  RUMC  is  NO.  1 

4.4.19  SMOKE. 

(a)  general  form:  SMOKE,  option  word  1,  option  word  2, 
option  word  3 

(b)  Allowable  choices  for  option  word  1: 

(1)  SMOKE  ROUNDS  FIRED  or  SMKRNDS 

(2)  PROBABILITY  SMOKE  KILLS  MISSION  or  PRBSMOKE. 

Allowable  choices  for  option  word  2:  i 

(1)  a  numerical  value 

Allowable  choices  for  option  word  3: 

(1)  a  numerical  value. 

(c)  If  option  word  1  is  SMOKE  ROUNDS  FIRED,  SMKRNDS,  or 
omitted,  then  option  words  2  and  3  respectively  give  the 
numbers  of  type  1  smoke  rounds  fired  and  type  2  smoke  rounds 
fired. 

If  option  word  1  is  PROBABILITY  SMOKE  KILLS  MISSION  or  PRBSMOKE; 
then  option  word  2  gives  the  probability  that  smoke  kills  the  potential 
COPPERHEAD  fire  mission. 

I 

J 

The  default  for  option  word  1  is  SMKRNDS.  The  default  for  option  word 
2  is  484  when  option  word  1  is  SMOKE  ROUNDS  FIRED  or  SMKRNDS,  but  it  is  .40 
when  option  word  1  is  PROBABILITY  SMOKE  KILLS  MISSION  or  PRBSMOKE. 

The  default  for  option  word  3  is  846  when  option  word  1  is  SMOKE 
ROUNDS  FIRED  or  SMKRNDS;  it  is  unused  otherwise. 


with 


Note:  When  the  first  alternative  for  SMOKE  option  word  1  is 
chosen,  the  probability  that  smoke  aborts  the  potential  COPPERHEAD  mission 
is  calculated  as  a  function  of  the  number  of  smoke  rounds  of  each  type 
fired  and  the  weather  conditions. 

When  the  second  alternative  is  used,  the  value  input  for  option  word 
2  (a  probability  between  0  and  1)  is  used  as  the  probability  that  smoke 
aborts  the  potential  COPPERHEAD  mission.  (See  section  2.2.6) 

4.4.20  DO  ARTILLERY  PK. 

(a)  general  form:  DO  ARTILLERY  PK,  option  word  1  or 
DOARPK,  option  word  1 

(b)  Option  word  1  must  be  either  a  numerical  value  between  0 
and  1  or  omitted. 

(c)  The  numerical  value  input  for  option  word  1  is  used  as 
the  probability  that  the  D.O.  is  killed  by  RED  preparatory 
artil lery  fire. 

The  default  value  is  .01. 

4.4.21  TARGET  VELOCITY. 

(a)  general  form:  TARGET  VELOCITY,  option  word  1  or  TGTVEL , 
option  word  1 

(b)  Option  word  1  is  a  positive  number  which  gives  the  iarget 
velocity  in  meters  per  second.  (The  program  is  currently 
set  up  to  accept  only  2,  3,  5,  8,  or  9  as  allowed  vel  city). 

(c)  The  value  of  option  word  1  is  used  as  the  target  velocity. 

The  default  target  velocity  is  obtained  from  a  table  (part  of 
the  acquisition  range  data  block)  giving  target  velocities  as  a  function 
of  day  or  night,  weather,  and  terrain  type. 

Note:  For  side  effects  of  velocity  choice,  see  section  4.8. 

4.4.22  MAXIMUM  DESIGNATOR  RANGE. 

(a)  general  form:  MAXIMUM  DESIGNATOR  RANCE,  option  word  1 
or  MAXDESRNG,  option  word  1 

(b)  Option  word  1  is  a  positive  number  giving  the  maximum 
designator  range  in  meters.  This  is  the  designator  range 
mentioned  in  section  2.2.4. 
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The  default  maximum  designator  range  is  obtained  from  a  table 
giving  ranges  as  a  function  of  designator  type  and  day  or  night. 

Note:  For  side  effects  of  designator  range  value,  see  section  4.8. 

4.4.23  BAIL  OUT  RANGE. 

(a)  general  form:  BAIL  OUT  RANGE,  option  word  1  or 
BAILOUTRNG,  option  word  1 

(b)  Option  word  1  is  a  positive  number  giving  the  bail-out 
range  in  meters  (  see  section  2.2.8  and  2.2.10).  The 
default  bail-out  range  is  1000m. 

4.4.24  TIME  OF  FLIGHT. 

(a)  general  form:  TIME  OF  FLIGHT,  option  word  1  or 
TOF,  option  word  1 

(b)  Option  word  1  is  a  positive  number  giving  the  time  of  flight 
of  the  COPPERHEAD  round  in  seconds. 

The  default  value  for  time  of  flight  is  obtained  from  a  table 
giving  times  of  flight  as  a  function  of  gun-to-target  range. 

Note:  For  side  effects  of  time  of  flight  value,  see  section  4.8. 

4.4.25  ANGLE  T. 

(a)  general  form:  ANGLE  T,  option  word  1 

(b)  Option  word  1  is  a  number  giving  the  angle  (in  degrees) 

'  between  the  gun-to-target  line  and  the  designator-to-target 

line.  The  default  value  is  25  degrees. 

Note:  For  side  effects  of  angle  T  value,  see  section  4.8. 

4.4.26  DUST. 


(a)  general  form:  DUST,  option  word  1 

(b)  Option  word  1  is  a  number  from  0  to  1  whose  value  is 
the  probability  that  dust  kills  the  potential  COPPERHEAD 
mission. 

The  default  value  is  .37. 

4.4.27  PROBABILITY  OF  SUCCESSFUL  VOICE  TRANSMISSION. 


(a)  general  form:  PROBABILITY  OF  SUCCESSFUL  VOICE  TRANS¬ 
MISSION,  option~word  i  or  PRBVOCTRAN,  option  word~T 


(b)  Option  word  1  is  a  number  from  0  to  1  whose  value  is  the 
probability  that  voice  communication  is  established  between  the  D.O.  and 
the  battery  FDC. 

The  default  value  is  .975. 

4.4.28  PROBABILITY  OF  SUCCESSFUL  DIGITAL  TRANSMISSION. 

(a)  general  form:  PROBABILITY  OF  SUCCESSFUL  DIGITAL  TRANS¬ 
MISSION,  option  word  1  or  PRBDGTTRAN,  option  word  1 

(b)  Option  word  lisa  number  from  0  to  1  whose  value  is  the 
probability  that  digital  communication  is  established  be¬ 
tween  the  0.0.  and  the  battery  FDC. 

The  default  value  is  .915. 

4.4.29  ROUND  IN  FLIGHT  RELIABILITY. 

(a)  general  form:  ROUND  IN  FLIGHT  RELIABILITY,  option  word 
_1  or  RNDFLTREL,  option  word  1 

(b)  Option  word  1  is  a  number  between  0  and  1  whose  value  is 
the  probability  that  the  round  is  reliable  (functions 
properly). 

The  default  value  is  .96. 

4.4.30  TIME  BETWEEN  ROUNDS. 

(a)  general  form:  TIME  BETWEEN  ROUNDS,  option  word  1  or 
TBR ,  option  word  1 

(b)  Option  word  1  is  a  number  whose  value  is  the  time  (in 
seconds)  between  the  firing  of  successive  COPPERHEAD  rounds. 

The  default  value  is  20  seconds. 

4.4.31  NUMBER  OF  REPLICATIONS. 

(a)  general  form:  NUMBER  OF  REPLICATIONS,  option  word  1  or 
NUMREP,  option  word  1 

(b)  Option  word  1  is  the  number  of  replications  (i.e. ,  Monte 

Carlo  sample  size  of  potential  COPPERHEAD  fire  missions)  to  be 

used  for  the  current  case. 

4.4.32  NUMBER  OF  ROUNDS  TO  BE  FIRED. 

(a)  general  form:  NUMBER  OF  ROUNDS  TO  BE  FIRED ,  option 
word  1  or  NUMRNDS,  option  word  1 
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(b)  Option  word  1  is  the  number  of  rounds  to  be  fired  on  each 
potential  COPPERHEAD  fire  mission  of  this  case  that  reaches  the  point 
where  firing  occurs  (i.e.,  a  "snot"  event).  Since  each  round  is  fired  and 
completes  its  flight  (successfully  or  not)  before  the  next  round  arrives, 
one  may  choose  to  think  of  the  number  of  rounds  to  be  fired  as  the  number 
of  one  round  volleys  to  be  fired. 

The  default  value  is  6  rounds. 

4.4.33  NUMBER  OF  VEHICLES  PER  TARGET. 

(a)  general  form:  NUMBER  OF  VEHICLES  PER  TARGET,  option 
word  1  or  NUMVEHTGT,  option  word  1 

(b)  Option  word  1  is  the  number  of  vehicles  in  the  target 
col umn. 

The  default  value  is  10  vehicles. 


4.4.34  DISTANCE  BETWEEN  VEHICLES. 

(a)  general  form:  DISTANCE  BETWEEN  VEHICLES,  option  word  1 
or  DISTBVEH,  option  word  1 

(b)  Option  word  1  is  the  mean  distance  (in  meters)  between 
adjacent  vehicles  in  the  target  column. 

The  default  value  is  61  meters. 

4.4.35  GUN  TARGET  RANGE. 

(a)  general  form:  GUN  TARGET  RANGE,  option  word  1  or 
GTRNG,  option  word  1 

(b)  Option  word  1  is  the  gun-to-target  range  in  kilometers. 

The  default  value  is  8  kilometers. 

Note:  For  the  side  effects  of  gun-to-target  range,  see  section  4.8. 

4.4.36  REFLECTIVITY. 

(a)  general  form:  REFLECTIVITY,  option  word  1  or  REFLECT , 
option  word  1 

(b)  Option  word  lisa  number  between  0  and  1  whose  value  is 
the  reflectivity  of  the  target  to  laser  energy  (i.e.,  it  is  the 
fraction  of  the  laser  energy  at  the  designator's  frequency  that 
is  reflected  by  the  target). 


The  default  value  is  .10. 


Note:  The  side  effects  of  reflectivity  are  discussed  in  section  4.8. 

4.4.37  DEFLECTION  BIAS. 

(a)  general  form:  DEFLECTION  BIAS,  option  word  1  or  DEFB , 
option  word  1 

(b)  Option  word  1  is  the  value  in  meters  of  the  deflection 
bias  which  is  to  be  defined  as  the  minimum  distance 
from  the  target  column's  path  (a  line)  to  the  footprint 
centroid  (a  point). 

The  default  value  is  0. 

Note:  The  side  effects  of  deflection  bias  are  discussed  in 
section  4. ’51 


4.4.38  TARGET  HEADING. 

(a)  general  form:  TARGET  HEADING,  option  word  1  or  TGTHDG, 
option  word  1 

(b)  Option  word  1  is  a  number  whose  value  is  the  angle  (in 
degrees)  between  the  target's  line  of  travel  and  the 
target-to-gun  line. 

The  default  value  is  0. 

Note:  The  side  effects  of  target  heading  are  discussed  in 
section  4.&I 


4.4.39  SEEKER  SENSITIVITY. 

(a)  general  form:  SEEKER  SENSITIVITY,  option  word  1  or 
SEEKSENS,  option  word  1 

(b)  Option  word  lisa  number  whose  value  is  the  minimum 
amount  (threshold  value)  of  energy  per  area  (in  joules  per 
square  meter)  that  must  reach  the  COPPERHEAD  seeker  in 
order  to  initiate  maneuver. 

The  default  value  is  60  joules/m^.  (The  true  value  is  not  used 
as  the  default  to  avoid  any  possible  classification  problem.) 

Note:  The  side  effects  of  the  seeker  sensitivity  value  are 
discussed  in  section  4.8. 


4.4.40  PROBABILITY  OF  A  CORRECT  MESSAGE. 


(a)  general  form:  PROBABILITY  OF  A  CORRECT  MESSAGE,  option 
word  1  or  PROBCPRMSG,  option  wordT 

(b)  Option  word  1  is  a  number  whose  value  is  the  probability 
that  the  D.O.  sends  correct  information  to  the  FDC  and  the 
FDC  interprets  it  correctly. 

The  default  value  is  .975. 

4.4.41  PROBABILITY  DO  WARNED  TO  LASE. 

(a)  general  form:  PROBABILITY  DO  WARNED  TO  LASE,  option  word 
2  or  PROBDQWARN,  option  wordT 

(b)  Option  word  1  is  a  number  whose  value  is  the  probability  that 
the  message  warning  the  0.0.  to  begin  lasing  for  the  first 
COPPERHEAD  round  is  transmitted  and  received  successfully. 

The  default  value  is  .975. 

4.5  Special  keywords:  OVERRIDE,  TEMPORARY,  RESET. 

4.5.1  Correspondence  of  Data  Blocks  to  Keywords.  As  mentioned 
previously,  a  large  part  of  the  data  used  in  each  case  is  grouped  into 
eight  blocks.  Each  of  these  blocks  is  normally  filled  by  reading  a  record 
from  a  word  addressible  mass  storage  file  that  is  created  by  the  PREPMS 
and  PAM  programs.  The  choice  of  which  particular  record  to  read  from 
the  file  to  fill  each  data  block  depends  on  the  various  keywords  and  option 
words  for  the  case. 

This  correspondence  of  data  blocks  to  keywords  can  be  summarized 
as  follows: 


Record  to  be  read  for 
data  block  of  this  type 

(1)  Weather 

(2)  Acquisition  range  data 

(3)  Response  time  data 

(4)  Direct  fire  suppression  data 

(5)  Random  occurrence  data 

(6)  Probability  of  engagement  data 


Depends  on  options 
for  this  (these)  keywords 

WEATHER 

ACQRNGDIST 

RESPTIME 

DFIRESUPPR 

ACQRNGDIST  and  TGTVEL 

RESPTIME,  MSNCODE,  DESIGTYPE, 
TGTVEL,  GTRNG,  REFLECT,  ANGLE 
T,  DEFLB,  TGTHDG,  SEEKSENS 
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(7) 

Target  posture  distribution 

F0  POSITION 

(8) 

Invariant  data 

INVARIANT 

As  can  be  seen,  there  is  but  one  keyword  influencing  the  choice 
of  record  to  be  read  for  each  data  block  except  in  the  cases  of  random 
occurrence  data  and  probability  of  engagement  data. 

4.5.2  OVERRIDE  and  TEMPORARY  Features.  Two  additional  methods 
of  filling  in  a  data  block'  are  provided.  The  first  is  to  choose  a  record 
from  the  word  addressible  mass  storage  file  to  be  read  into  the  data  block 
without  regard  to  the  options  chosen  for  the  keyword(s)  that  would  normally 
determine  the  record  choice;  this  is  the  OVERRIDE  feature.  The  second  is 
to  actually  supply  alternative  data  as  traditional  formatted  FORTRAN  inputs 
to  be  read  into  the  data  block;  this  is  the  TEMPORARY  feature. 

The  OVERRIDE  option  is  provided  primarily  so  that  one  can  choose 
to  use  probability  of  engagement  (f’E)  data  that  has  been  generated  with 
one  set  of  conditions  under  other,  not  too  different,  conditions  without 
having  to  re-run  the  PAM  program.  For  example,  PE  data  for  a  case  with 
nominal  response  time,  130  sec.  could  be  used  to  run  a  case  identical  (in 
those  factors  affecting  PE)  except  for  a  nominal  response  time  of  150  sec. 

The  advantage  of  this  procedure  is  that  one  can  avoid  re-running  the  relatively 
expensive  PAM  program  in  those  cases  where  the  factors  affecting  PE  have 
changed  very  little.  The  disadvantage,  of  course,  is  that  there  are  no 
efficient  objective  criteria  available  to  determine  whether  the  errors 
introduced  by  using  wrong  (but,  it  is  hoped,  approximate)  PE  data  are 
significant  in  a  given  situation. 

The  TEMPORARY  option  is  provided  so  that  one  can  directly  load 
data  into  any  data  block  without  having  to  use  the  PREPMS  preprocessor 
program.  This  option  allows  one  to  use  data  for  a  given  run  without  running 
the  PREPMS  program  to  make  that  data  a  "permanent"  record  in  the  data  base 
file.  This  option  was  provided  for  flexibility,  but  was  not  exercised  at 
all  in  the  original  COPPERHEAD  Operational  Performance  Evaluation  done  for 
the  COEA. 


4.5.3  Using  the  OVERRIDE. 

(a)  general  form:  OVERRIDE  ,  keyword,  option  word  1  or 
OVERIDE,  keyword,  option  word  1 

(b)  Choices  for  keyword  are: 

(1)  WEATHER  or  W 

(2)  ACQUISITION  RANGE  DISTRIBUTION  or  ACQRNGDIST 

(3)  RESPONSE  TIME  or  RESPTIME 
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(4) 

DIRECT  FIRE  SUPPRESSION  or  DFIRESUPPR 

(5) 

RANDOM  OCCURRENCE  DISTRIBUTION 

or  RODIST 

(6) 

PEDATA 

(7) 

TARGET  POSTURE  DISTRIBUTION  or 

TGTPSTDIST 

(8) 

INVARIANT 

Option  word  1  is  the  name  of  any  record  (on  the  random  access 
mass  storage  data  base  file)  containing  data  for  the  data  block  type  specified 
by  the  keyword  choice. 

(c)  The  OVERRIDE  causes  the  selected  data  block  (or  blocks, 
if  more  than  one  OVERRIDE  card  is  used  in  a  case)  to  be 
filled  with  data  from  the  record  whose  name  is  option  word  1. 

There  is  no  default  for  OVERRIDE.  An  error  will  result  from  the 
omitting  of  either  the  keyword  or  option  word  1. 

Note:  If  the  record  name  includes  one  or  more  blanks  or  separators 
then  the  record  name  must  be  preceded  by  a  "$"  (dollar  sign).  The  ten 
characters  forming  the  record  name  must  immediately  follow  the  dollar 
sign,  any  blanks  in  the  name  must  be  included  in  their  proper  positions, 
and  no  excess  blanks  may  be  inserted.  For  present  purposes,  separators  include 
commas,  slashes,  question  marks,  and  parentheses. 

4.5.4  Using  TEMPORARY. 

(a)  general  form:  TEMPORARY,  keyword  or  TEMP ,  keyword 

(b)  Choices  for  keyword  are  as  in  section  4.5.3. 

(c)  The  use  of  the  TEMPORARY  option  will  cause  the  program 

to  begin  reading  data  in  FORTRAN  formatted  fashion.  Hence, 
each  use  of  the  TEMPORARY  option  must  be  immediately  fol¬ 
lowed  by  the  formatted  data  cards  to  be  read  to  fill  the 
data  block  selected  by  the  keyword. 

The  formats  to  be  used  and  the  data  to  be  supplied  for  each 
block  are  identical  to  those  used  by  the  PREPMS  program  for  the  corresponding 
block  (see  section  14.4.2). 

Note:  If  the  keyword  is  PEDATA,  then  one  has  the  further  option 
of  reading  the  formatted  cards  from  a  separate  file  (TAPE  4).  To  use 
this  option,  a  card:  USE  TAPE  4  must  be  the  next  card  after  the  TEMPORARY, 
PEDATA  card;  then  the  formatted  data  should  be  on  a  file  to  be  read  by 
I/O  unit  4. 


There  is  no  default  for  TEMPORARY. 
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4.5.5  RESET. 


(a)  general  form:  RESET,  keyword 

(b)  Allowable  keywords  are  as  in  section  4.5.3. 

(c)  This  card  will  reset  the  default  conditions  for  the 
keyword  chosen.  Its  use  is  mainly  to  undo  an  OVERRIDE  or 
a  TEMPORARY  without  having  to  use  NEXT  CASE,  RD  which 
might  reset  other  defaults  not  desired. 

Note:  The  effect  of  an  OVERRIDE  or  TEMPORARY  used  on  PEDATA 
or  RANDOM  T5CUURRENCE  DISTRIBUTION  (RODIST)  can  be  undone  only  by  a  RESET, 
a  NEXT  CASE,  RD,  or  another  OVERRIDE  or  TEMPORARY  for  the  same  data  block. 

The  effect  of  an  OVERRIDE  or  TEMPORARY  for  any  other  data  block 
can  also  be  undone  by  a  card  of  the  usual  form  for  that  data  block's  keyword 
( i . e . ,  keyword,  option  word  1,  option  word  2, - ). 

There  is  no  default  on  the  RESET  card. 

4.6  Comments. 

4.6.1  General  Remarks  on  Comments.  The  program  allows  three 
types  of  user  comment  cards  to  be  included  in  the  input.  In  addition,  the 
program  itself  generates  some  comments  under  certain  conditions.  The 
program  generated  comments  are  detailed  in  sections  7.1  and  7.2. 

User  comments  in  the  input  card  deck  (or  card  image  file)  are 
identified  by  having  "$"  (dollar  sign)  in  the  first  one,  two,  or  three 
columns  of  the  card. 

4.6.2  $  Comments.  Cards  having  a  "$"  in  column  1  but  not  in 
column  2  are  user  comment  cards  which  are  totally  ignored  by  the  program. 
When  one  is  read,  the  program  merely  goes  to  the  next  input  card  and  reads 
that. 


This  type  of  comment  is  provided  only  so  that  the  user  can 
leave  reminders,  separate  sections  of  input,  or  otherwise  label  inputs 
without  having  an  effect  on  program  printouts. 

4.6.3  $$  Comments.  Cards  having  "$"  in  columns  1  and  2  but 
not  in  column  3  are  user  comment  cards  which  are  reproduced  within  the 
current  case's  printout  only. 

The  comment  (contents  of  the  card)  will  be  reproduced  (less 
the  first  two  columns)  with  the  symbols  "**  USER  **"  preceding  it  in 
the  comment  section  of  the  case's  printout.  (See  sample  case,  Appendix  D  .) 

These  comments  should  be  used  to  note  any  special  details 
about  a  case. 
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4.6.4  $$$  Comments.  Cards  having  "$"  in  columns  1,  2,  and  3 

are  user  comments  that  are  printed  out  immediately  upon  being  encountered 
by  the  program.  Again  the  symbols  "**  USER  **"  are  appended  to  the  front 
of  the  comment  and  the  $'s  in  columns  1-3  are  removed. 

These  comments  are  printed  on  a  special  page  separate  from  any 
case's  printout.  It  was  originally  intended  that  ”$$$"  comments  be  put  at 
the  beginning  of  the  input  before  the  FIRST  CASE  card;  however,  wherever 
they  are  put  a  special  page  will  be  printed  containing  them,  and  this  page 
will  occur  in  the  printout  immediately  after  the  previous  case's  printout; 
or,  (if  there  has  been  no  case  run  yet)  immediately  after  the  title  page. 

4.7  DATA  Statement  Data. 

There  are  many  data  which  are  set  in  data  statements  rather  than 
read  in  from  cards  or  disk  file  with  each  run  or  case. 

As  a  general  rule,  these  data  are  either  labels  (alphanumeric 
data)  or  numbers  that  do  not  change  from  run  to  run. 

All  of  these  data  statements  have  been  collected  into  the  BLOCK  DATA  sub¬ 
program  CDATA1.  They  are  now  described  common  block  by  common  block: 

4.7.1  ABRLBL.  This  common  block  contains  the  abort  labels 
(i.e.,  alphanumeric  texts)  that  identify  the  abort  causes  on  the  printouts. 
They  reside  in  the  IDAERT  array  and  are  entered  as  Hollerith  constants. 

4.7.2  ACHAR.  This  common  block  consists  of  the  CHAR  array 
which  contains  the  keywords  used  to  input  COPE  case  descriptors.  Each 
keyword  is  entered  as  a  string  of  Hollerith  constants.  In  addition,  corre¬ 
sponding  to  each  keyword  character  string  are  two  numbers,  the  first  of 
which  is  the  keyword  number  and  the  second  of  which  is  the  number  of 
distinct  option  word  character  strings  allowed  with  that  keyword.  (Note: 

The  second  number  as  entered  in  the  data  statement  line  for  each  keyword 

is  overwritten  by  numbers  taken  from  the  record  named  OPTNNUMS  on  the 
random  access  mass  storage  data  base  file.  Thus,  when  the  number  of  distinct 
optionword  character  strings  allowed  with  a  given  keyword  changes,  there 
is  no  need  to  adjust  the  data  statement;  the  pre-processor  program  PREPMS 
is  used  to  adjust  the  value  in  OPTNNUMS  to  the  correct  value.  (See  section 
14.5.) 

Also,  NREC,  the  total  number  of  keyword  character  strings,  is 
set  in  this  common  block's  data  statements. 

4.7.3  DESRNG.  This  common  block  contains  the  DESRNG  array 
which  consists  of  the  default  values  for  maximum  designator  range. 

DESRNG  (I,  J)  is  the  maximum  designator  range  for  designator 
type  I  under  condition  J  where  J=1  for  day  and  J=2  for  night. 


4.7.4  DISPLY.  This  common  block  contains  the  DISPT,  DISPM, 
RECLBL,  and  TMPLBL  arrays,  all  of  which  are  defined  in  the  variable  glossary 
(see  chapter  12).  Each  of  these  arrays  consists  of  alphanumeric  constants 
entered  as  Hollerith  data. 

4.7.5  FLTTIM.  This  common  block  consists  of  the  TOFARY  array. 

The  array  gives  the  default  times  of  flight:  TOFARY  (I)  is  the  COPPERHEAD 
time  of  flight  for  a  gun-to-target  range  of  I  (currently  only  1=8  and  1=12 
are  used). 


4.7.6  FSRESP.  This  common  block  consists  of  the  F5RT  array 
which  contains  the  FT  Sill  supplied  response  time  distribution. 

4.7.7  HEADNG.  This  common  block  contains  the  ACQLBL,  DAYLBL, 
DFSLBL,  DGTLBL,  DOLBL,  ROLBL,  and  RSPLDL  arrays  all  of  which  are  defined 
in  the  glossary  of  variables  (chapter  12). 

Each  of  these  arrays  consists  of  alphanumeric  constants 
entered  as  Hollerith  data. 

4.7.8  LOGFLG.  This  common  block  contains  various  logical  flags: 
FIRSTL,  SEQNML,  SPCL  array,  and  SHRTEC  all  of  which  are  defined  in  the 
glossary  of  variables  (chapter  12). 

These  are  all  logical  type  variables. 

4.7.9  POINT.  This  common  block  contains  the  IPOINT  array  used 
in  Subroutine  INPUT  to  direct  control  to  various  parts  of  a  computed 
GOTO. 


4.7.10  SMOKED.  Only  the  SMK2  and  SMK5  arrays  plus  the  variable 
FRONT  of  this  common  block  are  filled  in  via  data  statements.  They  are 
all  defined  in  the  variable  glossary  (chapter  12). 

4.7.11  STITLE.  This  common  block  contains  SLVERS  and  the  VERDAT 
array.  Both  are  used  in  the  title  page  printout. 

4.7.12  SYMBOL.  This  common  block  consists  of  the  ALFBET,  ANUMBR, 
and  SEP  arrays  plus  the  single  variables  BLANK,  DECPNT,  and  DOLLAR.  They 
are  all  alphanumeric  constants  filled  in  as  Hollerith  data  and  defined  in 
the  glossary  of  variables  (chapter  12). 

4.7.13  XVALUE.  This  common  block  contains  the  XVALUE  array 
which  is  used  to  generate  PEDATA  record  names.  (See  sections  5.4  and 
9.34. ) 
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4.8  Side  Effects  of  Certain  Inputs. 

There  are  a  number  of  dependencies  and  side  effects  connected 
with  some  of  the  inputs. 

First,  the  choice  of  response  time  data  (4.4.15)  and  mission  code 
(4.4.8)  together  with  time-of-f 1 ight  determine  the  nominal  response  time. 
(Time-of-fl ight  itself  may  be  determined  either  by  direct  input  (4.4.24)  or 
as  a  result  of  the  choice  of  gun-to-target  range  (4.4.35)). 

The  nominal  response  time,  designator  type  (4.4.11),  target 
velocity  (4.4.21),  angle  T  (4.4.25),  gun-to-target  range  (4.4.35),  reflec¬ 
tivity  (4.4.36),  deflection  bias  (4.4.37),  target  heading  (4.4.38),  and 
seeker  sensitivity  (4.4.39)  are  all  used  to  determine  the  name  of  the  PE 
data  record  (see  section  5.4).  Indeed,  angle  T,  reflectivity,  deflection 
bias,  target  heading,  and  seeker  sensitivity  play  no  other  roles  in  COPE 
than  to  affect  the  PE  data  (by  dete,  mining  the  PE  data  record  name)  and  to 
appear  on  the  case  heading  page  (see  section  6.3)  for  identification  purposes. 

The  maximum  designation  range  (4.4.22)  depends  on  the  time  of  day 
(day  or  night)  input  with  response  time  data  (4.4.15)  and  the  designator 
type  (4.4.11).  The  maximum  designator  range  can  also  be  set  by  direct 
input  (4.4.22);  however,  the  user  must  take  care  to  see  that  the  PE  data  as 
well  as  TTF  and  RNGTTF  arrays  contain  values  appropriate  for  the  maximum 
designator  range  used. 

The  target  velocity  (4.4.21)  can  be  input  directly  or  as  a  result 
of  the  time  of  day  (day  or  night)  used  for  the  response  time  data  (4.4.15), 
the  month  used  for  weather  (4.4.13),  and  the  terrain  type  (4.4.14)  used  for 
acquisition  data.  (The  VELTBL  array  may  need  adjusting  if  additional  choices 
are  allowed  for  acquisition  data  or  weather.) 

Finally,  the  weather  data  (4.4.13)  has  a  strong  side  effect  on 
the  effectiveness  of  smoke  when  the  SMOKE  option  (4.4.19)  that  plays  a 
specified  number  of  smoke  rounds  is  used. 
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CHAPTER  5 


5.  PREPARING  TO  RUN  COPE 

Prior  to  running  the  main  COPE  program,  it  is  necessary  to  run 
the  preprocessor  programs  to  create  the  word  addressable  mass  storage  data 
base  file  (TAPE  11).  This  chapter  describes  the  role  of  each  preprocessor , 
the  structure  of  TAPE  11,  and  the  interfacing  of  TAPE  11  with  each  of  the 
programs  by  means  of  the  record  names. 

5.1  Preprocessor  Programs. 

There  are  three  programs  that  may  be  regarded  as  preprocessors 
to  the  main  COPE  simulation  program.  These  three  programs  are  called: 

(1)  PREPMS  which  stands  for  preprocessor  mass  storage, 

(2)  PRBLOS  which  stands  for  probabi  1  ity  of  h'ne-of -Right, 
and 

(3)  PAM  which  stands  for  £robability  of  seeker  Requisition 
and  round  maneuver. 

More  detailed  information  on  PREPMS,  PRBLOS,  and  PAM  is  included 
in  chapters  14,  15,  and  16  respectively  of  this  report.  In  addition,  more 
thorough  documentation  of  PAM  is  to  be  published  in  a  future  separate 
AMSAA  Technical  Report. 

As  mentioned  in  chapter  4  of  this  report,  much  of  the  data  used 
in  each  COPE  case  is  grouped  into  eight  data  blocks.  These  data  blocks 
are  filled  by  reading  records  from  TAPE  11  (except  in  the  case  of  the 
TEMPORARY  option  described  in  section  4.5).  The  main  purpose  of  the  PREPMS 
proyram  (and  one  of  the  purposes  of  the  PAM  program)  is  to  fill  values 
into  the  records  on  TAPE  11  in  such  a  way  that  they  are  accessible  to  the 
main  COPE  program. 

The  PREPMS  program  is  used  to  fill  in  records  for  data  blocks 
for  weather  data,  acquisition  range  data,  response  time  data,  direct  fire 
suppression  data,  random  occurrence  data,  target  posture  data,  and  invariant 
data.  It  can  also  be  used  to  fill  in  records  for  PE  (probability  of  enyageme 
data,  but  this  feature  has  never  been  used  because  the  PAM  program  which 
generates  PE  data  has  been  modified  to  write  its  results  directly  fa  TAPE 
11  and  the  choice  of  record  name  has  been  entirely  automated  in  this  case. 
Finally,  the  PREPMS  program  is  also  used  to  establish  and  modify  the  option 
words  allowed  as  choices  with  each  keyword  (described  in  sections  4.4.1 
through  4.4.19  except  for  those  optionword  choices  described  as  "a  numerical 
value"  in  sections  4.4.18  and  4.4.19). 


r 


The  PR8L0S  program  is  used  to  calculate  the  probabilities  of 
1  ine-of-sight  at  various  ranges.  These  values  are  then  used  in  the  random 
occurrence  1 i ne-of-sight  model.  They  are  read  from  the  PRCLOS  printout 
and  entered  by  hand  as  input  to  PREPMS.  Because  the  PRRLCS  program  does 
not  directly  act  on  TAPE  11,  it  shall  not  concern  us  further  in  this  chapter 
(see  chapter  15  for  complete  discussion  of  PRBLPS). 

The  PAfl  program  takes  as  input  the  parameter  values  describing 
the  conditions  under  which  probability  of  engagement  is  to  be  computed. 

It  then  computes  the  PE  data  values,  creates  a  record  name  for  its  current 
block  of  PE  data  by  encoding  the  input  conditions  according  to  a  scheme 
also  used  in  the  main  COPE  program,  and  then  writes  the  PE  data  to  TAPE  11 
under  that  record  name. 

5.2  Word  Addressable  Mass  Storage  Data  Base  File  (TAPE  II). 

The  word  addressable  mass  storage  data  base  file  (TAPE  11)  consists 
of  the  records  containing  the  data  to  be  used  by  each  of  the  eight  data 
blocks  mentioned  in  chapter  4,  the  records  of  option  words  allowed  with 
each  keyword  (applies  only  to  keywords  described  in  sections  4.4.1  through 
4.4.19  and  excludes  any  option  words  described  as  "a  numerical  value"),  and 
a  record  called  0PTNNUMS  that  records  the  number  of  option  word  character 
strings  allowed  for  each  keyword. 

TAPE  11  is  a  CDC  word  addressable  mass  storage  file  using  a 
name  type  master  index.  (This  file  type  and  the  way  it  is  interfaced 
with  a  FORTRAN  program  is  explained  in  the  CDC  Fortran  Extended  Version  4 
Reference  Manual  chapter  8,  a  section  titled  "Mass  Storage  Input/Output"). 

The  important  feature  to  note  here  is  that  this  file  type  (with  a  name 
type  master  index)  is  organized  as  a  set  of  records  each  consisting  of  one 
or  more  words  of  data  and  each  having  a  unique  record  name  of  one  to  ten 
characters.  This  unique  record  name  is  set  when  the  record  is  created  and 
must  be  used  by  any  program  that  either  reads  or  modifies  the  record.  It 
is  by  using  the  same  system  of  record  names  in  the  COPE  program  as  in  the 
preprocessors  PREPPE  and  PREPMS  that  the  data  records  written  by  the  pre¬ 
processors  can  be  read  by  the  main  COPE  program. 

5.3  Record  Names. 


5.3.1  Weather  Data  Record  Name.  The  record  name  of  the 
data  to  be  used  in  the  weather  data  block  (the  WDATA  array)  has  the  form  : 
mmmtttt021  where  mmm  are  the  first  three  letters  of  the  name  of  the  month 
of  the  weather  data,  tttt  are  four  numbers  giving  the  time  of  day  (24  hour 
military  time)  of  the  weather  data,  and  the  021  are  three  numbers  signifying 
that  WEATHER  has  keyword  number  21. 

Examples : 

JUN0600021  is  the  record  name  for  weather  data  for  a 
June  day  at  0600  (6  AM). 


SEP2200021  is  the  record  name  for  weather  data  for  a 
September  day  at  2200  (10  PM). 


5.3.2  Acquisition  Data  Record  Name.  The  record  name  of  the 
data  to  be  used  in  the  acquisition  range  data  block  (the  ACQDAT  array) 
has  the  form:  ACQDATnn22  where  nn  are  two  digits  giving  the  number  of  the 
choice  for  option  word  1  used  with  keyword  22  (section  4.4.14). 

Examples: 

ACQ0AT0122  is  the  record  name  of  the  acquisition  range  and 

LOS  segment  length  data  to  be  used  when  option  word 
AVERAGE  is  used  with  keyword  22  (ACQRNGDIST) 

ACQDAT0322  is  the  record  name  of  the  data  to  be  used  with 
OPEN  terrain. 

5.3.3  Response  Time  Data  Record  Name.  The  record  name  of 
the  data  to  be  used  in  the  response  time  data  block  (RSPDAT  array)  is 
of  the  form:  RSPDATnn23  where  nn  are  two  digits  giving  the  number  of 
the  choice  for  option  word  1  used  with  keyword  23  (section  4.4.15) 

Examples: 

RSPDAT01 23  is  the  name  of  the  record  containing  the 

response  time  data  to  be  used  when  the  FTSILL  option 
is  selected. 

RSPDAT0223  is  the  name  of  the  record  containing  the 
response  time  data  for  the  STAUCH  option. 

Note:  There  is  no  data  record  corresponding  to  the  PARAM  choice 
for  option  word  1.  This  is  because  the  PARAM  choice  for  option  word  1 
causes  the  program  not  to  require  any  of  the  data  in  the  response  time 
data  block. 


5.3  4  Direct  Fire  Suppression  Data  Record  Name.  The  record 
name  of  the  data  to  be  used  in  the  direct  fire  suppression  data  block 
(DFSDAT  array)  is  of  the  form:  DFSDATnn24  where  nn  are  two  digits  giving 
the  number  of  the  choice  for  option  word  1  used  with  keyword  24  (section 
4.4.16) 


Example: 

DFSDAT0124  is  the  record  name  for  HIGH  direct  fire  suppression 
data. 

5.3.5  Random  Occurrence  Data  Record  Name.  The  record  name 
of  the  data  to  be  used  in  the  random  occurrence  data  block  (RODATA  array) 
is  of  the  form:  RODAVmTRNn  where  m  is  the  target  velocity  in  meters  per 
second  (obviously  between  0  and  9)  and  n  is  the  terrain  type  number  (corresponds 


to  number  of  option  word  1  on  ACQRNGDIST  card,  i.e.,  1  for  AVERAGE,  2  for 
CLOSE,  3  for  OPEN). 

Example : 

R0DAV8TRN2  is  the  record  name  for  the  random  occurrence 

data  to  be  used  when  target  velocity  is  8  m/s  and 
terrain  type  is  2  (CLOSE). 

Note:  The  program  is  currently  set  up  only  for  velocities  of 
2,  3,  5,  8,  and  9.  Furthermore,  2  and  8  are  treated  as  3  and  9  respectively 
when  it  comes  to  looking  up  RODATA  and  PEDATA. 

5.3.6  Target  Posture  Distribution  Data  Record  Name.  The  record 
name  of  the  data  to  be  used  in  the  target  posture  data  block  (PSTDAT  array) 
is  of  the  form:  PSTDATnn27  where  nn  is  the  number  of  the  choice  for  option 
word  1  used  with  keyword  17  (section  4.4.12). 

Example: 

PSTDAT0127  is  the  record  name  for  the  target  posture  distribution 
used  when  FO  POSITION  is  VANTAGE  POINT. 

Note:  Keyword  17  (FO  POSITION)  and  keyword  27  (TARGET  POSTURE 
DISTRIBUTION)  could  each  be  used  to  control  the  choice  of  target  posture 
distribution  data,  but  only  keyword  17  (FO  POSITION)  has  been  provided 
with  optionwords  and  is  the  only  one  of  the  two  explained  in  section  4.4. 

5.3.7  Invariant  Data  Record  Name.  The  record  name  of  the 
data  used  in  the  invariant  data  block  (AlNVDA  array)  is  of  the  form: 
AINVDAnn28  where  nn  is  the  number  of  the  choice  for  option  word  1  used 
with  keyword  28. 

Example: 

AINVDA01 28  is  the  record  name  for  the  invariant  data  used 
with  the  default  (omitted)  option  word  1. 

Note:  The  keyword  INVARIANT  is  currently  set  up  to  accept  no 
option  words'  (other  than  a  blank  which  is  equivalent  to  the  default). 

5.3.8  Option  Word  Record  Names.  For  each  keyword  numbered 
less  than  41  (see  section  5.3.9  for  keyword  numbers)  there  may  be  some 
option  words  that  are  not  numerical  values  (see  sections  4.4.1  through 
4.4.19  for  the  current  option  word  choices  available  with  each  keyword). 

To  create,  modify,  or  add  to  the  list  of  character  strings 
that  can  be  used  with  any  keyword,  it  is  necessary  to  run  PREPMS  with 
input  specifying  the  keyword  (in  its  abbreviated  form  of  ten  characters  or 
less),  the  total  number  of  option  word  character  strings  that  can  be  used 
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with  that  keyword  and  the  keyword  number  as  well  as  the  option  word  number, 
the  option  word  choice  number  and  the  option  word  character  string  for 
each  option  word  choice.  The  formatting  of  this  data  is  explained  in  chapter 
14,  but  an  explanation  of  its  meaning  is  provided  by  the  sample  input 
fol lowing: 


OPTION  WORDS,  W,  10,  21 
1,  2,  JUNE 

1,  2,  J 

2,  2,  DECEMBER 
2,  2,  D 

1,  3,  1400 

1,  3,  14 

2,  3,  0600 

2,  3,  06 

3,  3,  2200 
3,  3,  22 


where  the  first  line  indicates  that  option  word  allowable  choices  are 
being  set  for  keyword  W  (or  WEATHER),  that  ten  optionword  character 
strings  are  being  input,  and  that  W  (or  WEATHER)  is  keyword  number  21. 


Each  of  the  next  ten  lines  establishes  a  character  string  as 
a  possible  option  word  choice.  For  example,  1 ,  3,  1400  establishes 
1400  as  a  character  string  corresponding  to  the  first  choice  for 
option  word  2  of  any  input  line  beginning  with  keyword  W  (or  WEATHER). 

The  first  digit  (1)  indicates  that  1400  is  the  first  choice  allowed, 
the  second  digit  3  indicates  that  l400  is  a  choice  allowed  for  the 
third  item  on  the  input  line  (recall  that  an  input  line  is  of  the  form: 
Keyword,  option  word  1,  option  word  2,  -  -  option  word  n  so  that 
option  word  2  is  actually  the  third  item  on  an  input  line),  and,  of 
course,  1400  indicates  that  the  input  character  string  to  select  option  1 
for  option  word  2  is  1400.  The  fact  that  the  next  line  is  1,  3,  14  means 
that  has  the  same  effect  (first  choice  for  option  word  2)  as  1400. 

No  more  than  two  lines  are  allowed  to  be  input  with  the  same  ordered  pair 
(choice  number,  option  word  number  +  1)  under  any  given  keyword  (though  one 
may  input  just  one  line  for  such  a  pair  if  desired). 


The  PREPMS  program  then  places  this  option  word  information  on  a 
record  whose  record  name  is  the  keyword  (W  in  the  case  above).  It  is  for 
this  reason  that  the  keyword  used  must  be  ten  or  fewer  characters.  Each 
keyword  of  length  more  than  ten  characters  also  has  an  abbreviated  form 
(see  the  appropriate  section  of  chapter  4  for  each  keyword;  even  some 
keywords  of  length  less  than  ten  characters  have  abbreviated  forms).  For 
example,  the  keyword  ACQUISITION  RANGE  DISTRIBUTION  is  suitable  for  input 
to  COPE,  but  cannot  be  used  as  input  to  PREPMS  because  it  is  too  long  to 
be  a  record  name;  instead,  the  abbreviated  form  ACQRNGDIST  must  be  used 
when  setting  option  words  via  PREPMS. 
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The  rule  is  always  to  use  the  abbreviated  form  of  the  keyword 
with  PREPMS  input  (even  if  the  long  form  of  the  keyword  is  itself  ten  or 
fewer  characters)  and  to  use  either  form  with  input  to  COPE.  For  keywords 
with  only  one  form,  use  it  as  input  to  both  programs. 

Finally,  for  each  new  option  word  choice  that  is  allowed,  the 
user  must  consider  what  COPE  will  do  when  it  encounters  the  new  option  word. 

In  the  case  of  option  words  that  control  the  choice  of  records  to  be  read 
from  TAPE  11  into  data  blocks,  the  user  must  also  have  run  PREPMS  to  add 
the  possible  data  block  records  into  TAPE  11.  In  our  example  above,  input 
to  PREPMS  must  have  created  records  named  JUN0600021,  JUN1400021,  JUN2200021, 
DEC0600021,  DEC1400021,  and  DEC2200021  containing  the  weather  data  to  be 
used  with  each  of  the  possible  option  word  combinations.  For  the  case  of 
option  words  that  control  program  actions  rather  than  select  a  data  record 
name,  it  will  usually  be  necessary  to  modify  the  program  code  so  that  it 
will  "know"  what  to  do  when  encountering  a  new  option. 

5.3.9  Keyword  Numbers,  Abbreviated  Forms,  Etc.  The  fol 1 owi ng 
table  gives  the  current  list  of  allowed  keywords,  each  keyword's  number, 
abbreviated  form,  and  relevant  notes.  (This  overlays  some  of  the  information 
in  chapter  4,  but  it  was  felt  desirable  to  have  all  the  keywords  listed 
in  one  place  for  quick  reference;  chapter  4,  sections  4.4.1  -  4.4.38  are 
still  essential  for  allowed  optionwords  and  detailed  effects  of  keywords). 
When  two  consecutive  keywords  have  the  same  number,  the  second  is  the 
abbreviated  form.  (Recall  that  blanks  may  be  arbitrarily  inserted  in 
(or  removed  from)  keywords.)  Notes  are  explained  at  end  of  listing. 


Keyword  Number 

Keyword 

Notes 

1 

FIRST  CASE 

*1 

Sec.  4.4.1 

2 

NEXT  CASE 

*2 

Sec.  4.4.2 

3 

END  OF  CASE 

*1 

Sec.  4.4.3 

3 

END 

*1 

II 

4 

END  OF  FINAL  CASE 

*1 

Sec.  4.4.4 

4 

END  F 

*1 

II 

5 

PLOT 

*2 

Sec.  4.4.5 

6 

OVERRIDE 

*3 

Sec.  4.5.3 

6 

OVERIDE 

*3 

il 

7 

TEMPORARY 

*3 

Sec.  4.5.4 

7 

TEMP 

*3 

II 
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8 

RESET 

*3  Sec.  4.5.5 

9 

CONTROL 

*2  Sec.  4.4.6 

11 

LINE  OF  SIGHT  MODE 

*2  Sec.  4.4.7 

11 

LOS  MODE 

*2  " 

12 

MISSION  CODE 

*2,  *9  Sec.  4.4. 

12 

MSN  CODE 

*2,  *9 

13 

NUMBER  OF  DIFFERENT  TARGET 
POSTURES 

*2  Sec.  4.4.9 

13 

NUMDIFTGTP 

*2  Sec.  4.4.9 

14 

TARGET  TYPE 

*2  Sec.  4.4.10 

16 

DESIGNATOR  TYPE 

*2,  *9  Sec.  4.4. 

16 

DESIGTYPE 

*2,  *9  " 

17 

FO  POSITION 

*4  Sec.  4.4.12 

21 

WEATHER 

*4  Sec.  4.4.13 

21 

W 

*4  11 

22 

ACQUISITION  RANGE  DISTRIBUTION 

*4  Sec.  4.4.14 

22 

ACQRNGDIST 

*4  « 

23 

RESPONSE  TIME 

*2,  *4,  *9  Sec. 

23 

RESPTIME 

*2,  *4,  *9  " 

24 

DIRECT  FIRE  SUPPRESSION 

*4  Sec.  4.4.16 

24 

DF IRESUPPR 

*4  " 

25 

RANDOM  OCCURRENCE 

DISTRIBUTION 

*10 

25 

RODIST 

*10 

26 

PEDATA 

*10 

27 

TARGET  POSTURE  DISTRIBUTION 

*10 

I 


.4.15 
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Keyword 


TGTPSTDSST 

*10 

INVARIANT 

*5 

Sec. 

4.4.17 

RUMC 

*6 

Sec. 

4.4.18 

SMOKE 

*7 

Sec. 

4.4.19 

DO  ARTILLERY  PK 

*8 

Sec. 

4.4.20 

OOARPK 

*8 

M 

TARGET  VELOCITY 

*9 

Sec. 

4.4.21 

TGTVEL 

*9 

Sec. 

4.4.21 

MAXIMUM  DESIGNATOR  RANGE 

*8 

Sec. 

4.4.22 

MAXOESRNG 

*8 

n 

BAIL  OUT  RANGE 

*8 

Sec. 

4.4.23 

BAIL  OUTRNG 

*8 

ll 

TIME  OF  FLIGHT 

*8 

Sec. 

4.4,24 

TOF 

*8 

II 

ANGLE  T 

*9 

Sec. 

4.4.25 

DUST 

*8 

Sec. 

4.4.26 

PROBABILITY  OF  SUCCESSFUL 
VOICE  TRANSMISSION 

*8 

Sec. 

4.4.27 

PRBVOCTRAN 

*8 

H 

PROBABILITY  OF  SUCCESSFUL 
DIGITAL  TRANSMISSION 

*8 

Sec. 

4.4.28 

PRBDGTTRAN 

*8 

n 

ROUND  IN  FLIGHT  RELIABILITY 

*8 

Sec. 

4.4.29 

RNDFLTREL 

*8 

n 

TIME  BETWEEN  ROUNDS 

*8 

Sec. 

4.4.30 

Notes 


Keyword  Number 

Keyword 

Notes 

51 

TBR 

*8 

Sec.  4.4.30 

52 

NUMBER  OF  REPLICATIONS 

*8 

Sec.  4.4.31 

52 

NUMREP 

*8 

il 

53 

NUMBER  OF  ROUNDS  TO  BE  FIRED 

*8 

Sec.  4.4.32 

53 

NUMRNDS 

*8 

ii 

54 

NUMBER  OF  VEHICLES  PER 

TARGET 

*8 

Sec.  4.4.33 

54 

NUMVEHTGT 

*8 

II 

55 

DISTANCE  BETWEEN  VEHICLES 

*8 

Sec.  4.4.34 

55 

DISTBVEH 

*8 

II 

56 

GUN  TARGET  RANGE 

*9 

Sec.  4.4.35 

56 

GTRNG 

*9 

II 

57 

REFLECTIVITY 

*9 

Sec.  4.4.36 

57 

REFLECT 

*9 

II 

58 

DEFLECTION  BIAS 

*9 

Sec.  4.4.37 

58 

DEFLB 

*9 

II 

59 

TARGET  HEADING 

*9 

Sec.  4.4.38 

59 

TGTHDG 

*9 

II 

60 

SEEKER  SENSITIVITY 

*9 

Sec.  4.4.39 

60 

SEEKSENS 

*9 

II 

61 

PROBAB 1 1  ' '  G.  "  'ORRECT  MESSAGE 

*8 

Sec.  4.4.40 

61 

PROBCORMSG 

*8 

II 

62 

PROBABILITY  DO  WARNED  TO  LASE 

*8 

Sec.  4.4.41 

62 

PROBDOWARN 

*8 

II 
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Explanation  of  notes: 

*1  These  keywords  do  not  take  option  words. 

*2  These  keywords  set  certain  flags  or  indices  that  cause  the 

program  to  function  in  one  of  several  alternate  ways  or  else  serve  as 
indices  for  array  "look-ups."  Any  increase  in  the  number  of  options 
correspondi ng  to  one  of  these  keywords  might  require  code  changes  to 
COPE  (at  the  least,  redimensioni ng  of  some  arrays)  to  specify  the  actions 
to  be  taken  for  the  new  options. 

*3  These  keywords  take  other  keywords  (numbers  21  through  28)  as 
their  second  fields  (i.e.,  as  the  first  item  following  the  separator 
after  the  keyword).  The  items  to  be  used  in  the  second  fields  are  built 
into  the  program  in  data  statements  (CHAR  array)  and  any  changes  would 
require  code  modifications  to  COPE.  (See  sections  4.5.1  through  4.5.5) 

*4  These  keywords  set  the  names  of  records  on  TAPE  11  to  he  read 
into  the  program  data  blocks.  Any  increase  in  the  number  of  options 
allowed  must  be  accompanied  by  input  to  PREPMS  creating  the  records  with 
the  names  that  would  be  called  for  if  the  new  options  were  exercised. 

(See  chapter  14.) 

Also,  keyword  23  takes  some  further  option  words  which  determine 
digital  or  voice  communications  and  day  or  night  visibility.  If  more 
options  are  allowed  for  these  keywords,  then  code  changes  are  required 
for  COPE. 

*5  Currently  takes  no  option  words,  but  if  option  words  were  added, 
it  would  fall  in  the  same  class  as  keywords  with  note  *4. 

*6  The  addition  of  any  new  options  for  RUMC  would  require  code 
changes  to  COPE. 

*7  The  addition  of  any  new  options  for  SMOKE  would  require  code 
changes  to  COPE. 

*8  These  keywords  all  take  numerical  values  for  option  word  1. 

Any  numerical  value  that  could  be  read  in  F10.4  format  is  allowable 
though  for  some  option  words  negative  values  or  values  greater  than  1.0 
may  cause  program  malfunction  (as  in  the  case  when  the  value  represents 
a  probability).  Any  attempt  to  modify  one  of  these  keywords  to  accept 
options  other  than  numbers  would  require  program  code  changes  in  COPE. 

*9  These  keywords  affect  the  choice  of  the  PEDATA  record  name  to 
be  used  (see  section  5.4).  Any  increase  in  the  number  of  allowed  choices 
here  would  require  changing  values  in  the  XVALUE  array  (in  both  COPE  and 
PAM)  and  then  running  PAM  to  create  any  new  PEDATA  records  that  may  be 
called  for  as  a  result  of  these  changes. 
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In  short,  one  can  see  from  the  above  notes  that  while  it  is 
easy  to  add  new  optionword  choices  for  a  particular  keyword  (by  running 
the  PREPMS  program  when  necessary),  it  often  requires  code  changes  to 
COPE  to  make  the  new  choices  have  the  desired  effect.  About  the  only 
keywords  for  which  options  can  be  conveniently  changed  are  those  of 
notes  4,  5,  and,  to  a  lesser  extent,  9. 

5.4  PEDATA  Record  Names. 

The  record  name  for  the  PEDATA  (probability  of  engagement  data) 
to  be  used  with  a  given  case  is  a  function  of  ten  keywords  and  their 
associated  optionwords  (except,  of  course,  when  using  the  OVERRIDE  or 
TEMPORARY  keywords  with  PEDATA). 

When  the  PAM  program  is  run,  nine  parameters  are  input.  The 
values  of  these  parameters  determine  the  record  name  of  the  PEDATA  created' 
by  that  run.  When  COPE  is  run,  the  same  nine  parameters  are  assigned 
values  (as  the  result  of  keyword  inputs  or  defaults),  the  same  function 
for  determining  record  name  is  applied,  and  the  record  with  the  resulting 
name  is  read  from  TAPE  11  and  filled  into  the  PEDATA  data  block. 

Because  there  are  only  a  finite  number  of  ten  character  record 
names  and  because  the  record  name  depends  on  the  values  of  nine  different 
parameters,  it  is  necessary  to  limit  the  choices  allowed  for  each  parameter. 
This  section  is  devoted  mainly  to  a  description  of  the  function  that 
determines  record  name  when  given  the  nine  parameter  values  and  to  the 
changes  required  to  introduce  a  new  allowed  parameter  value. 

The  nine  parameters  are: 

(1)  nominal  response  time  in  seconds  (determined  by  keywords 
23  and  12), 

(2)  designator  type  (determined  by  keyword  16), 

(3)  target  velocity  (determined  by  keyword  42), 

(4)  gun-to-target  range  (determined  by  keyword  56), 

(5)  target  reflectivity  (determined  by  keyword  57), 

(6)  angle  T  (i.e. ,  angle  between  gun-target  line  and  desig¬ 
nator  target  line;  determined  by  keyword  46), 

(7)  deflection  bias  (determined  by  keyword  58), 

(8)  target  heading  (determined  by  keyword  59), 

(9)  seeker  sensitivity  (determined  by  keyword  60). 
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The  values  currently  allowed  are  (by  parameter  number): 

(1)  any  time  t  in  seconds  such  that  0.5  second  t  <999.5 
seconds 

(2)  GLLD ,  MULE,  LTD  (which  COPE  and  PAM  call  types  1,  2, 
and  3  respect i vely) 

(3)  2,  3,  5,  8,  and  9  meters  per  second, 

(4)  8  and  12  kilometers, 

(5)  .05,  .10,  .20,  and  .30, 

(6)  0,  25,  30,  60,  90,  and  120  degrees, 

(7)  -200,  -100,  0,  100,  and  200  meters, 

(8)  -60,  -30,  0,  30,  and  60  degrees, 

(9)  24,  36,  48,  60,  and  72  joules  per  square  meter. 

The  record  name  function  works  as  follows: 

-First,  it  rounds  the  nominal  response  time  (parameter  one  to  the  nearest 
integer  (call  the  result  t',  then  1  _<  t '  _<  999). 

-Next,  for  each  parameter  2  through  9,  the  function  matches  the  parameter 
value  to  one  of  the  allowed  values.  Say  for  the  jth  parameter,  the 
value  is  found  to  match  the  I jth  allowed  value  (if  no  match  is  found, 
an  error  stop  results). 

-Next,  the  record  name  is  made  by  converting  t'  to  octal  (call  it  t" 
where  l&<t"  0747g),  by  letting  N-j  =  a  function  of  Ij  (usually  I  j  - 1 ) , 
and  then  defining 

record  name  =  20053333XXXXN2N3N4N5N5N7N3N9  in  octal 

where:  20053333  is  octal  for  the  alphanumeric  "PE00",  xxxx  are  the  four 
octal  digits  of  t"  (possibly  with  leading  zero(s)  if  t"  is  small  enough), 

M2, _ ,  Ng  are  as  defined  above  (note  that  when  1  <  I  j  <8 ,  we  have  0  <N  -j  <7 

so  that  each  N-j  is  but  a  single  octal  digit.  It  is  for  this  reason 

that  we  shall  never  allow  more  than  eight  different  choices  for  the 
value  of  any  of  the  parameters  2  through  9). 

The  values  allowed  for  each  parameter  2  through  9  are  to  be 
found  in  the  XVALUE  array  which  is  defined  by  data  statements  in  both 

COPE  and  PAM  (also,  in  PREPMS).  In  COPE,  the  data  statement  is  in 

BDAT1 ,  in  PAM  it  is  in  subroutine  PENAME,  and  in  PREPMS  it  is  in  BDATA2. 


The  XVALUE  array  is  set  up  so  that  XVALUE  (I,J,K)  is  the  1th 
allowed  value  for  the  Jth  parameter  when  K  =  1  and  XVALUE  (I,J,K)  is  the 
Nj  value  (as  defined  above  a  function  of  Ij  with  0<Nj<7)  corresponding 
to  the  Ith  allowed  value  of  the  Jth  parameter  when  K=2. 

Notes :  (1)  Because  the  first  parameter  (nominal  response 

time)  is  allowed  a  wider  range  of  values,  the  XVALUE  entries  with  J  =  1 
are  not  used.  (2)  Because  XVALUE  is  dimensioned  XVALUE  (8,9,2)  and 
because  not  all  parameters  2  through  9  actually  use  the  maximum  of 
eight  different  allowable  values,  those  array  spaces  XVALUE  (I,J,1) 
and  XVALUE  (I,J,2)  for  I  greater  than  the  number  of  allowable  values 
for  parameter  J  are  filled  with  0‘s  and  8‘s  respectively.  Hence,  if 
an  NJ  value  of  8  were  to  occur,  the  program  has  made  an  invalid 
parameter  value  match  and  a  stop  with  error  message  will  occur. 

(3)  The  programs  do  not  distinguish  between  target  velocities  of  2  and  3 
m/s  or  between  3  and  9  m/s  or  between  designator  types  MULE  and  LTD 
when  it  comes  to  PE  data.  (There  are  still  distinctions  made  in  other 
parts  of  COPE  such  as  calculating  current  designator  target  ranges  or 
looking  up  LDWSS  probability  of  hit  numbers  as  function  of  designator 
type).  This  failure  to  distinguish  can  be  observed  in  the  XVALUE 
array:  the  XVALUE  (I,J,2)  values  are  identical  for  target  velocities 
of  2  and  3  m/s,  for  example. 

To  allow  more  choices  for  one  of  the  parameters  2  through  9, 
one  need  merely  modify  the  data  statements  defining  the  XVALUE  array 
so  that  XVALUE  (I,  J,  1)  with  appropriate  I  and  J  has  the  new  value 
and  XVALUE  (I,J,2)  has  the  corresponding  NJ  (octal  digit).  This  must 
be  done  in  both  COPE  and  PAI1  (and  should  be  done  in  PREPMS  to  keep 
it  current  also).  Then  one  must  run  PAM  with  the  parameter  combinations 
using  the  new  allowed  value(s)  to  create  the  PEDATA  corresponding  to  the 
case(s)  one  intends  to  run  in  COPE  with  the  new  parameter  values. 

To  allow  a  new  choice  for  parameter  1,  one  needs  merely  run 
PAM  with  the  new  value  for  parameter  1  to  create  the  PEDATA  for  the 
case(s)  using  the  new  nominal  response  time  and  the  desired  allowed 
values  for  the  other  parameters.  Of  course,  nominal  response  times 
outside  .5  seconds  to  999.5  seconds  are  not  allowed. 

Note:  The  PREPMS  program  uses  the  XVALUE  array  only  to  decipher 
PE  record  names.  That  is,  one  can  direct  that  program  to  list  the  PEDATA 
records  currently  on  TAPE  11  and  then  decipher  the  PE  record  names  and 
print  the  values  of  the  9  parameters  to  which  each  such  record  corresponds. 
It  is  for  this  reason  that  the  XVALUE  array  data  statement  in  PREPMS 
should  be  updated  along  with  those  in  COPE  and  PAM  whenever  a  new  value 
is  introduced  for  any  of  the  parameters  2  through  9. 

5.5  Control  Cards  for  COPE  and  Its  Preprocessors. 

The  appendixes  A,  B,  C,  and  D  at  the  end  of  this  report  include 
respectively,  the  control  cards  used  to  run  PAM,  PPBLOS,  PREPMS,  and 
COPE.  They  are  explained  in  these  appendixes  and  hence  require  no  further 
explanation  here.  These  control  card  sets,  of  course,  apply  only  to 
BRL's  computer  system  and  would  require  minor  changes  for  other  CDC 
i nstal lations  and  major  changes  for  non-CDC  computers. 
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Next  page  is  blank. 


CHAPTER  6 


6.  OUTPUT 


This  chapter  describes  the  normal  COPE  output  prints.  Special 
messages  and  diagnostic  or  error  prints  that  may  occur  are  described  in 
Chapter  7. 


The  normal  COPT  output  consists  of  four  types  of  pages,  three  of 
which  will  always  be  present  and  one  of  which  will  be  present  only  if  one 
or  more  "$$$"  comments  is  included  in  the  inpit. 

The  page  types  will  ordinarily  occur  in  this  order: 

Title  Page 

"$$$"  comment  page  (if  present) 

First  case  heading  page 
First  case  results  page 
Second  case  heading  page 
Second  case  results  page 

nth  case  heading  page 
nth  case  results  page 

final  case  heading  page 
final  case  results  page 

An  additional  "$$S"  comment  page  will  occur  following  the  results 
page  of  the  last  case  whose  END  card  precedes  any  "$$$'  comment  card  (or 
cards). 

Each  page  type  is  now  described  in  detail. 

6.1  Title  Page. 

This  page  includes  the  program  name,  the  names  of  the  program 
author  and  the  various  contributors  to  the  model  design  and  data  collection. 
In  addition,  it  identifies  the  activity,  division,  branch  and  section 
responsible  for  the  model. 

Of  greater  practical  value,  this  page  also  includes  the  version 
number  of  the  program  and  the  date  that  version  was  created.  Finally,  the 
'age  gives  the  date  and  time  of  the  current  run  of  the  program. 

For  an  example,  see  Listing  6-1. 

6.2  "$$$"  Comment  Page. 

This  page  merely  lists  the  user's  "$$$'  comments  (see  section 
4.6.4)  with  the  symbol  "**  USER  **"  to  the  left  of  each  comment  line.  In 
addition,  any  program  generated  comments  (see  section  7.1)  are  listed 
with  "**C0PE**"  to  the  left  of  each  comment  line. 
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****«*i**+*l»*t» ****** **♦♦**♦♦**♦'*♦♦♦ 


For  an  example,  see  Listing  6-2. 


6.3  Case  Heading  Page. 

The  first  page  for  each  case  is  the  heading  page.  The  heading 
page  gives  a  description  of  the  conditions  in  effect  for  the  case  whose 
results  follow.  In  addition,  the  heading  page  contains  a  section  for  any 
"$$"  comments  (either  user  or  program  generated).  The  case  heading  page 
(Listing  6-3)  begins  with  a  line  indicating  the  case  number.  The  next  line 
below  that  gives  the  number  of  replications  (i.e.,  number  of  potential 
Copperhead  missions  generated  arid  tested  by  the  current  case  of  the  Monte 
Carlo  COPE  model). 

The  next  area  of  the  case  heading  page  is  broken  up  into  nine 
boxes  each  of  which  is  surrounded  by  asterisks  and  contains  descriptors  of 
one  aspect  of  the  current  case.  These  boxes  are  now  described  one  at  a 
time. 

Note:  When  an  OVERRIDE  or  TEMPORARY  option  is  in  effect,  the 
case  heading  information  may  be  unreliable  for  those  items  connected  with 
the  data  block  for  which  the  OVERRIDE  or  TEMPORARY  is  in  effect. 

In  the  special  case  of  a  PE  data  block  input  via  the  OVERRIDE 
option,  the  values  given  in  the  comment  of  section  7.2.6  take  precedent 
over  those  in  the  case  heading  when  it  comes  to  determining  PE  data  but  not 
for  other  purposes  (for  example,  velocity  used  for  calculating  designator- 
to-target  range  is  the  velocity  printed  in  the  TARGET  box  rather  than  that 
in  the  comment). 

If  in  doubt,  the  user  should  look  at  the  contents  (Data  Check)  of 
TAPE  8  for  the  case  in  question  (see  section  7.6)  to  determine  which  values 
were  actual ly  used  for  various  parameters. 

6.3.1  TARGET.  The  first  box  is  labeled  "TARGET"  and  contains 
data  describing  the  target.  These  data  are: 

(a)  Target  type 

(b)  number  of  vehicles  in  the  target  unit, 

(c)  mean  distance  between  target  vehicles, 

(d)  target  velocity  (speed) 

(e)  target  heading  (where  a  heading  of  zero  means  the  target 
is  moving  along  the  gun-to-target  line  toward  the  gun. 

Angles  are  measured  counterclockwise  from  this  zero  heading). 

(f)  target  reflectivity. 


6.3.2  FIRING  INFO,  Moving  vertically  down  the  page,  one  next 
finds  the  FIRING  INFO  box  which  gives  various  information  about  the  firing 


* 
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LISTING  6-2  "$$$"  COMMENT  PAGE 


of  the  COPPERHEAD  round.  These  items  are: 


(a)  number  of  rounds  fired  per  engagement, 

(b)  round  in-flight  reliability 

(c)  time  between  successive  rounds 

(d)  time  of  flight  of  round 

(e)  nominal  gun-to-target  range 

(f)  angle  T  {angle  between  target-to-gun  line  and  target- 
to-designator  line) 

(g)  deflection  bias  (which  is  the  minimum  distance  between  the 
COPPERHEAD  footprint  centroid  and  the  target's  path). 

6.3.3  MISC.  The  next  box  below  the  FIRING  INFO  is  labeled  MISC 
and  contains  miscellaneous  data  relevant  to  the  case.  These  data  are: 

(a)  either  a  note  that  DELTA  T3  is  zero  (in  which  case 

RUMC  (see  section  4.4.18)  is  optimally  chosen  for  each  fire 
mission  or  a  note  that  DELTA  T3  is  not  assumed  to  be  zero  in 
which  case  RUMC  is  a  fixed  value  for  each  fire  mission. 

(b)  The  value  of  RUMC  (if  DELTA  T3  is  not  assumed  zero; 
otherwise,  this  line  is  not  printed.) 

(c)  The  seeker  sensitivity  value  used  for  the  COPPERHEAD 
seeker  in  this  case. 

6.3.4  DETECT,  COMMO,  and  PROC  TIMES.  The  next  box  which  is 
located  at  the  top  of  the  second  column  of  boxes  contains  data  pertaining 
to  detection,  communication,  and  processing  times.  These  data  are: 

(a)  The  mission  type 

(b)  The  type  of  communication  (i.e.,  digital  or  voice) 

(c)  day  or  night  indicator 

(d)  nominal  response  time  (which  is  the  sum  of  the  median 
communication  and  processing  times  and  the  time  of  flight) 

(e)  probability  of  successful  digital  communication  link 

being  established  when  needed  (not  printed  when  item  (b)  above 
is  VOICE) 


(f)  probability  of  successful  voice  communication  link 

being  established  when  needed  (printed  only  when  applicable 
-  see  section  2.2.9) 

(g)  probability  of  a  correct  message, 

(h)  probability  that  the  D.O.  is  vjarned  to  lase. 

If  the  parameterized  response  time  option  is  used,  then  the 
parameterized  response  time  (which  does  not  include  time  of  flight) 
is  listed  in  this  box  first. 

6.3.5  DESIGNATOR.  The  next  box  gives  information  about  the 
designator  (both  the  soldier  and  the  piece  of  equipment).  This  information 
consists  of: 

(a)  designator  type, 

(b)  maximum  designator  range, 

(c)  bail-out  range 

(d)  designator  location. 

6.3.6  DESIGNATOR  SUPPRESSED.  The  next  box  gives  information 
about  suppression  of  the  designator.  This  information  is: 

(a)  The  probability  that  the  FO  (D.O.)  is  killed  by  Red 
preparatory  artillery  fires. 

(b)  A  label  giving  the  level  of  direct  fire  suppression 
achieved  by  the  target  against  the  D.O. 

6.3.7  WEATHER.  The  first  box  of  the  third  column  gives  weather 
data.  These  data  are: 

(a)  The  month  whose  weather  is  being  used  in  the  current 
case, 

(b)  The  time  of  day  (on  a  0  to  2400  clock)  whose  weather  is 
being  used  in  the  current  case. 

6.3.8  TERRAIN  AND  LOS.  The  next  box  moving  down  has  terrain 
and  line-of-sight  information.  This  information  includes: 

(a)  The  terrain  type  used  for  the  acquisition  range  distri¬ 
bution  and  line-of-sight  segment  length  distribution. 

(b)  The  line-of-sight  model  used  in  the  current  case 
("SHOOTING  GALLFRY"  or  "RAMDOIl  OCCURRENCE"). 
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6.3.9  OBSCURANTS.  The  final  box  gives  data  on  obscurants 
(smoke  and  dust ).  These  data  are: 

(a)  Probability  that  smoke  is  sufficiently  dense  to  k i 1 1  a 
potential  COPPERHEAD  mission. 

(b)  Number  of  smoke  rounds  fired  of  types  one  and  two 
respectively  to  obtain  the  level  of  smoke  in  (a)  above. 

(This  is  printed  only  if  smoke  effects  are  played  as  a  func¬ 
tion  of  number  of  smoke  rounds  fired  (see  section  4.4.19). 

(c)  Probability  that  dust  from  RED  HE  artillery  fire  is 
sufficient  to  abort  a  potential  COPPERHEAD  mission. 

6.3.10  "$$"  Comment  Section. 

The  final  section  of  the  heading  page  for  each  case  consists  of 
a  comment  section.  This  comment  section  includes  both  any  user  comments 
for  this  case  as  well  as  any  program  generated  comments. 

If  a  case  has  no  comments  of  either  type,  then  the  comment  section 
is  omitted. 

6.4  Case  Results  Page. 

Following  the  heading  page  for  a  given  case  is  the  case  results 
page.  This  page  is  labeled  in  such  a  fashion  as  to  be  almost  self-explan¬ 
atory  (see  Listing  6-4). 

The  page  has  one  line  corresponding  to  each  mission  abort  condition 
and  two  lines  for  each  round  abort  condition.  A  mission  abort  occurs 
whenever  one  of  the  tests  that  affect  the  entire  potential  COPPERHEAD 
mission  is  failed  (see  sections  2.2.2  through  2.2.11);  a  round  abort 
occurs  whenever  one  of  the  tests  that  affect  the  functioning  of  a  single 
round  is  failed  (see  sections  2.2.12-2.2.20). 

Beginning  at  the  top  of  the  results  page,  one  finds  the  number 
of  occasions,  which  is  the  number  of  potential  COPPERHEAD  missions  sampled 
for  the  current  case.  This  number  should  equal  the  number  of  replications 
on  the  heading  page  for  the  same  case. 

The  first  seven  abort  causes  (or  tests)  are  those  which  would 
prevent  the  D.O.  from  even  attempting  to  employ  COPPERHEAD  against  a 
target. 


Each  of  these  causes  of  abort  has  one  line  giving  the  following 
i nformation: 


(a)  The  number  of  the  abort  cause  (or  test), 

(b)  a  label  describing  the  cause  of  abort, 


(00001)  SNUI3V33U  ***** 


(c)  the  number  of  times  the  test  was  failed, 


(d)  the  percentage  of  the  total  occasions  that  failed  the 
test 

(e)  The  number  of  potential  COPPERHEAD  fire  missions  on 
which  the  test  was  performed,  (this  number  is  equal  to  the 
total  number  of  potential  COPPERHEAD  fire  missions  minus 
the  number  of  potential  missions  that  failed  prior  tests). 

(f)  The  percentage  of  those  potential  COPPERHEAD  fire  missions 
on  which  the  test  was  performed  that  passed  the  test. 

Following  the  seventh  abort  cause  is  a  line  giving  the  number 
of  attempted  engagements.  This  is  the  number  of  replications  (out  of 
the  total  original  number  of  potential  COPPERHEAD  missions)  that  passed 
the  first  seven  tests  and  have,  therefore,  reached  the  point  where  the 
D.O.  attempts  to  cal  1  for  COPPERHEAD  fire. 

The  next  four  cause-of-abort  lines  (abort  causes  numbers  8 
through  11)  consist  of  those  tests  that  must  be  passed  before  the  battery 
will  fire  a  COPPERHEAO  mission.  Each  of  these  abort  causes  has  one  line 
giving  information  as  described  in  (a)  through  (f)  above  in  this  section. 

Following  the  eleventh  cause-of-abort  line  is  a  line  giving 
number  of  shots.  This  is  the  number  of  replications  for  which  the  mission 
reached  the  point  where  the  battery  actually  fired  COPPERHEAD  ( i . e. ,  the 
mission  passed  tests  1  through  11).  The  number  of  shots  is  the  number 
of  missions  fired,  not  the  number  of  individual  rounds  fired. 

The  final  eight  abort  causes  (numbers  12  through  19)  are  round 
aborts  which  have  two  lines  each  in  the  printout. 

The  first  line  of  each  round  abort  cause  gives: 

(a)  The  number  of  the  abort  cause  (test), 

(b)  a  label  describing  the  cause  of  abort, 

(c)  the  number  of  times  the  test  was  failed  for  the  first 
round, 

(d)  the  percentage  of  the  total  occasions  for  which  the 
first  round  failed  the  test. 

The  line  continues  with  items  (c)  and  (d)  repeated  but  for 
the  second  and  subsequent  rounds  up  to  a  total  of  NR F  rounds  (NRF_<6). 
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The  second  line  of  each  round  abort  gives 

(e)  the  number  of  COPPERHEAD  mission  first  rounds  on  which 
the  test  was  performed, 

(f)  the  percentage  of  those  COPPERHEAD  fire  mission  first 
rounds  on  which  the  test  was  performed  that  passed  the  test. 

The  second  line  continues  with  items  (e)  and  (f)  repeated 
but  for  the  second  and  subsequent  rounds  of  the  COPPERHEAD  fire  mission. 

Following  the  final  (19th)  abort  cause  line  is  a  line  giving 
kills.  This  line  gives  the  number  of  replications  for  which  the  first 
round  of  the  COPPERHEAD  mission  achieved  a  kill,  the  number  of  replications 
for  which  the  second  round  of  the  COPPERHEAD  mission  achieved  a  kill, 
and  so  on  through  the  final  round  of  the  COPPERHEAD  mission. 

Next,  the  printout  gives  a  number  of  probabi 1 ities  derived 
from  the  case  just  simulated:  (these  probabilities  are  printed  as 
percentages). 

The  probability  of  kill  given  an  occasion  for  the  nth  round 
of  the  fire  mission  is  printed  and  is  calculated  by  dividing  the  number 
of  kills  for  the  nth  round  by  the  number  of  occasions. 

The  probability  of  kill  given  an  attempted  engagement  for 
the  nth  round  equals  the  number  of  kills  for  the  nth  round  divided  by 
the  number  of  attempted  engagenents. 

The  probability  of  kill  given  a  shot  for  the  nth  round 
equals  the  number  of  kills  for  the  nth  round  divided  by  the  number  of 
shots. 

The  probability  of  1 i ne-of-sight  (LOS)  for  the  nth  round  is 
the  probability  of  having  LOS  when  the  round  arrives  (test  12)  given 
that  LOS  existed  immediately  prior  to  firing  (test  11).  (Note:  The 
preceding  applies  to  the  "shooting  gallery"  LOS  model;  for  random  occurrence, 
the  probability  of  having  1 i ne-of-sight  for  the  nth  round  is  just  equal 
to  the  success  rate  of  test  12). 

The  probability  of  shot  given  an  occasion  is  the  fraction  of 
potential  COPPERHEAD  fire  missions  that  actually  reach  the  point  where 
rounds  are  fired. 

The  probability  of  shot  given  an  attempted  engagement  is  the 
number  of  shots  divided  by  the  number  of  attempted  engagements. 

The  probability  of  attempted  engagements  given  an  occasion 
is  the  number  of  attempted  engagenents  divided  by  the  number  of 
occasions. 
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The  final  line  of  the  results  page  gives  information  on  designator 
survivability.  This  line  gives  the  number  of  replications  in  which  the 
designator  was  killed  by  direct  fire  from  the  target  and  the  percentage 
of  the  total  replications  that  number  represents.  The  line  also  gives 
the  number  of  replications  for  which  the  test  of  designator  kill  was 
performed  and  the  percentage  of  those  replications  in  which  the  designator 
was  not  killed. 

Note:  The  number  of  kills  shown  on  the  results  page  differs 
slightly  in  its  meaning  depending  on  whether  "shooting  gallery"  or  "random 
occurrence"  li ne-of-sight  model  is  used.  When  "shooting  gallery"  is 
used,  no  attempt  is  made  to  account  for  multiple  kills  of  the  same  target 
vehicle  (i.e.,  the  number  of  kills  on  the  nth  round  is  calculated  under 
the  assumption  that  the  vehicle  the  round  hit  had  not  already  been  killed 
by  a  previous  round). 

When  "random  occurrence"  is  used,  the  number  of  kills  on  the 
nth  round  takes  into  account  the  number  of  vehicles  surviving  to  the 
nth  round. 

This  difference,  of  course,  has  no  effect  in  comparing  first 
round  kills  computed  using  the  two  differing  LOS  models.  Furthermore, 
for  round  n  there  will  be  no  effect  from  this  difference  in  bookkeeping 
if  (1)  n  _<  number  of  vehicles  in  the  target,  (2)  distance  between  target 
vehicles/target  velocity  <  time  between  rounds,  and  (3)  the  D.O.  is  assumed 
always  to  designate  the  front  most  target  vehicle  in  view.  In  other 
cases,  the  results  obtained  by  the  two  methods  will  have  some  differences 
attributable  to  the  difference  in  bookkeeping  between  the  two  methods. 


CHAPTER  7 


7.  PROGRAM  GENERATED  MESSAGES  AND  DEBUGGING  PRINTS 

The  COPE  program  has  been  designed  so  that  most  of  the  common 
errors  will  cause  the  program  to  come  to  a  stop  and  print  an  error  message. 
Of  course,  it  is  not  possible  to  anticipate  every  possible  error  and  the 
user  can  expect  occasionally  to  encounter  a  run  that  terminates  with  a 
dump  or  a  system  generated  error  message.  However,  the  current  version 
of  COPE  has  been  used  for  hundreds  of  runs  now  and  has  not  terminated  in 
anything  other  than  the  normal  program  termination  or  one  of  the  anticipated 
error  stops. 

The  messages  generated  by  COPE  can  be  divided  into  five  classes: 

(1)  program  generated  $$$  comments, 

(2)  program  generated  $$  comments, 

(3)  special  program  print-outs  of  a  warning  nature  that  do 
not  result  in  program  termination 

(4)  special  program  prints  that  occur  with  abnormal  program  termin¬ 
ations  and  which  give  information  useful  in  locating  the  cause 
of  termination. 

(5)  STOP  messages  that  are  printed  in  the  day  file.  (These  STOPS 
include  the  subroutine  or  function  name  in  which  the  stop 
occurs.) 

The  messages  are  now  explained.  They  are  ordered  al phabetically 
(by  first  line)  within  each  class.  (Note  that  some  messages  include 
more  than  one  li ne). 


7.1  Program  Generated  $$$  Comments. 


DATA,  THE  RESULTS  MAY  BE  SUSPECT. 

This  message  is  generated  in  subroutine  SEPREC  and  is  part 
of  a  modification  added  to  handle  a  Control  Data  peculiar  problem. 
Users  of  COPE  frequently  create  TAPE  5  (the  file  of  case  descriptors) 
using  the  CDC  editor  in  its  default  FORTRAN  format  and  then  save  the 
resulting  file  by  the  command  SAVE,  LFN  (where  LFN  is  the  local  file 
name).  The  problem  is  that  the  editor  then  inserts  sequence  numbers 
in  columns  73-78  of  the  saved  file.  Now  one  could  easily  avoid  this 
problem  by  using  SAVE,  LFN,  N  rather  than  SAVE,  LFN  (the  additional  N 


r 


causing  no  sequence  numbers  to  be  saved).  However,  to  avoid  aborting 
runs  in  which  sequence  numbers  are  present,  COPE  was  modified  to  check 
the  first  non-comment  card  (or  card  image)  of  file  TAPE  5  for  sequence 
numbers:  if  columns  73-78  are  filled  with  numbers  and  columns  63-72 
and  79-80  are  blank,  then  the  computer  concludes  that  sequence  numbers 
are  present,  issues  the  above  comment,  and  ignores  columns  73-78  on 
all  cards  of  the  current  run. 

As  mentioned  in  the  message  itself,  this  ignoring  of  columns 
73-78  could  adversely  affect  the  results  if  the  TEMPORARY  option  is 
used,  since  that  option  quite  likely  has  important  information  in  columns 
73-78.  In  this  event,  the  file  TAPE  5  should  be  created  in  the  editor 
with  80  character  lines  ( i . e. ,  use  CDC  command  F,CH=80  before  creating 
the  file).  Then  when  it  is  saved,  the  sequence  numbers  will  be  in  columns 
not  read  by  the  program. 

For  keywords  other  than  TEMPORARY,  there  is  not  likely  to  be 
any  adverse  effect  since  the  case  descriptor  character  strings  on  the 
cards  will  usually  terminate  before  column  63  and  hence  the  deletion 
of  columns  73-78  will  have  no  effect. 

Finally,  if  the  computer  should  erroneously  conclude  that 
sequence  numbers  are  not  present  when  they  really  are  (as  could  happen 
if  any  of  columns  63-72  or  79-80  of  the  first  non-comment  card  were 
not  blank),  then  the  computer  would  treat  the  sequence  numbers  as  part 
of  the  keyword  or  optionword  and  a  different  error  would  bring  the 
program  to  a  halt  when  that  keyword  or  optionword  was  not  found  (see 
section  7.4.5). 

One  may  wish  to  remove  this  feature  if  using  a  non-CDC 

computer. 


7.2  Program  Generated  $$  Comments. 

7.2.1  CHOICE  OF  option  word  FOR  RESPONSE  TIME  DATA  IS 

INCONSISTENT  WITH  TIME  OF  option  word  FOR  WEATHER  DATA. 


The  first  option  word  is  DAY  or  NIGHT  while  the  second  one  is 
0600,  1400,  or  2200. 

This  message  merely  warns  the  user  that  one  of  the  following 
pairs  of  a  RESPONSE  TIME  data  option  word  and  a  WEATHER  data  option  word 
is  being  used: 

RESPONSE  TIME  option  word  WEATHER  option  word 

DAY  2200 

NIGHT  0600 


NIGHT 


1400 


AD-A100  285  ARMY  MATERIEL  SYSTEMS  ANALYSIS  ACTIVITY  ABERDEEN  PROV— ETC  F/G  19/1 

COPPERHEAD  OPERATIONAL  PERFORMANCE  EVALUATION  (COPE):  COMPUTER  — ETC(U) 
MAR  81  R  S  SANDMEYER 

UNCLASSIFIED  AMSAA-TR-318 _ _ _ NL 


These  are  all  considered  inconsistent  pairs  since  daylight 
is  usually  gone  by  2200.  On  the  other  hand,  day  light  is  usually 
present  at  0600  and  1400. 

The  choice  of  one  of  these  inconsistent  pairs  will  not  abort 
the  program,  but  merely  result  in  the  generating  of  this  message  and 
the  executing  of  the  case  with  the  inconsistent  data  selected. 

7.2.2  IN  CCPL0T  FOR  CASE  nn  WITH  ICCPFG=  1.  NO  PLOT  PRODUCED. 


nn  is  the  case  number. 

This  message  merely  means  that  the  user  wanted  a  Cal  Comp  plot 
for  case  number  nn,  but  since  the  plot  routine  is  not  yet  implemented, 
no  plot  was  produced. 

7.2.3  IN  PPL0T  FOR  CASE  nn  WITH  IPPFG  =  1.  NO  PLOT  PRODUCED. 


nn  is  the  case  number. 

This  message  merely  means  that  the  user  wanted  a  printer 
plot  for  case  number  nn,  but  since  the  plot  routine  is  not  yet  implemented, 
no  plot  was  produced. 

7.2.4  NO  ENDF  CARD  FOUND  BUT  ONE  ASSUMED  SINCE  END  OF  INPUT 


_ U 

This  message  occurs  when  no  ENDF  card  has  been  put  at  the 
end  of  TAPE  5  (INPUT).  It  merely  means  that  the  program  reached  the 
end-of-file  without  encountering  an  ENDF  card  and  then  proceeded  as 
though  it  had  found  one  there. 

7.2.5  NO  'FIRST  CASE'  OR  'NEXT  CASE'  CARD  FOUND  —  NEXT 


CASE,  RD  OPTION.  ASSUMED. 

This  message  means  that  inputs  for  a  new  case  (possibly  the 
first  case)  have  been  encountered,  but  were  not  preceded  by  a  'FIRST 
CASE'  or  'NEXT  CASE'  card.  In  this  event,  the  program  proceeds  as  though, 
a  NEXT  CASE,  RD  card  had  been  encountered  prior  to  the  new  case's  inputs. 


7.2.6  PEDATA  FOR:  TR=xxx.  DT=  n  VEL= 


ANGLET=  bbb.  DEFT=  ccc.  TGTHD=  dd. 


’  "  '  n  VEL=  yy.  GTR=  zzz.  REFL=  a.aa 


TGTHD=  dd.  SKSEN=  ee. 


xxx.,  n,  yy. ,  zzz.,  a.aa,  bbb.,  ccc.,  dd. ,  and  ee.  are  respectively 
the  response  time,  designator  type  number,  target  velocity,  gun-to-target 
range,  reflectivity  of  target,  angle  T,  deflection  bias,  target  heading,  and 
seeker  sensitivity  used  to  generate  the  PEDATA  used  in  this  run.  This 
message  occurs  only  when  the  OVERRIDE  option  is  used  with  PEDATA. 


The  units  used  with  each  quantity  are  those  normally  used  on 
the  corresponding  keyword  cards. 

7.2.7  RECORD  NAMED:  Record  Name  USED  TO  OVERRIDE  FOR  Data 
Block  Name. 

Here  record  name  is  the  name  of  the  record  on  the  word 
addressible  mass  storage  file  that  is  selected  by  the  OVERRIDE  option 
and  data  block  name  is  the  name  of  the  data  block  to  be  filled  by  this 
override. 


This  print  occurs  only  with  each  data  block  in  a  given  case 
for  which  the  OVERRIDE  is  in  effect. 

7.2.8  TEMPORARY  OPTION  IN  EFFECT  FOR  Data  Block  Name. 

Here  data  block  name  is  the  name  of  the  data  block  filled  by 
use  of  the  TEMPORARY  OPTION. 

This  print  occurs  only  with  each  data  block  in  a  given  case 
for  which  the  TEMPORARY  option  is  in  effect. 

7.2.9  YOUR  INPUT  LINE:  Input  Line  Characters  SUPERSEDES 
ONE  OF  YOUR  PREVIOUS  INPUT  LINES  FOR  THIS  CgSET 

The  input  line  characters  are  the  contents  of  the  card  that 
supersedes  a  previous  line.  This  message  is  only  a  warning  to  the 
user  that  he  has  included  two  (or  more)  cards  with  the  same  keyword  in 
a  single  case.  When  this  happens,  only  the  last  such  card  has  an 
effect  on  the  choice  of  case  descriptors. 

If  two  PLOT  cards  (section  4.4.5)  are  included  in  a  case  (one 
for  CALCOMP  and  one  for  PRINTER),  then  this  message  will  be  produced.  In 
such  a  case,  both  plot  types  are  set  according  to  the  input  cards  even 
though  the  message  says  the  last  one  superseded  the  earlier  one;  this  is 
the  one  case  in  which  this  message  can  be  safely  ignored. 

In  most  cases,  one  will  want  to  check  the  input  cards  and 
probably  re-run  the  case  so  that  no  more  than  one  card  is  used  for  each 
keyword.  Note  that  an  OVERRIDE  or  TEMPORARY  card  applied  to  a  certain 
keyword  counts  as  an  input  card  with  that  keyword  for  purposes  of  this 
message  (for  example,  putting  an  OVERRIDE,  W,  J UN 1 400021  card  and  a  W,  J, 
0600  card  in  the  same  case  will  produce  the  message  of  this  section). 

7.3  Special  Program  Print-Outs  of  a  Warning  Nature  That  Do  Not 

Result  in  Program  Termination. 

7.3.1  IN  OUTPUT.  PROBLEM  1  J=  nnnnn  RNDRED=xxxx.  NKILL  =  mmmmm. 


nnnnn  is  the  number  of  the  round,  xxxx.  is  the  number  of  kills 
on  the  Jth  round  for  this  case  calculated  by  adding  one  each  time  a  kill 
occurs,  and  mmmmm  is  the  number  of  kills  on  the  Jth  round  for  this  case 
calculated  by  subtracting  the  number  of  aborted  missions  and  Jth  rounds 
from  the  number  of  replications. 
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This  print  occurs  only  if  the  Jth  round  kills  (J  runs  from  1  to 
NRF)  computed  by  the  two  methods  differ.  It  indicates  a  serious  problem 
with  the  program. 


7.3.2  SERIOUS  PROBLEM!  KTEST  AND  NTEST  ARRAYS  DO  NOT  AGREE 


=  nnnnn 


Matrix). 


nnnnn  is  the  abort  number  and  mmmmm  is  the  round  number  (or  if 
nnnnn  corresponds  to  a  mission  abort,  mmmmm  is  1). 

II  and  JJ  are  the  indices  of  the  first  entry  in  the  KTEST  and 
NTEST  arrays  that  do  not  agree. 

The  20  x  6  matrix  is  the  KTEST  array  where  the  element  in  row  I 
column  J  is  KTEST  (I,  J).  The  NTEST  array  elements  correspond  to  the 
'number  tested'  values  printed  on  the  case  results  page  where  NTEST  (I, 

J)  corresponds  to  the  Jth  round  Ith  abort  condition  (when  the  abort  is  a 
mission  abort ,  J=1 ). 

The  KTEST  array  is  filled  by  incrementing  KTEST  (I,J)  each  time 
the  Ith  test  is  made  for  the  Jth  round  (if  the  test  is  for  a  mission 
abort  J=l).  The  NTEST  array  is  filled  by  setting  NTEST  (I,J)  equal  to 
the  number  of  replications  minus  the  number  of  missions  (and  Jth  rounds) 
aborted  by  tests  1  through  1-1. 

If  NTEST  and  KTEST  differ,  then  the  program  is  not  behaving 

correctly. 

ecial  Program  Prints  That  Occur  with  Abnormal  Program 


Termination  and  Which  Give  Information  Useful  in  Locatin 


the  Cause  of  Termination. 


7.4.1  ERROR  IN  INPUT.  LINE:  Character  String  WITH  ITl=nnnnn 


IS  IN  ERROR. 

The  character  string  is  the  card  image  read  from  TAPE  5  (INPUT) 
that  is  in  error  and  nnnnn  is  the  keyword  number. 

The  error  occurs  when  a  keyword  match  is  found  for  the  input, 
but  no  code  has  been  provided  to  handle  the  input.  This  is  a  serious 
error  and  means  that  a  program  change  is  required. 

This  message  corresponds  to  STOP  in  section  7.5.15. 

7.4.2  IN  COMMNT.  TOO  MANY  $$  COMMENTS  (>20):  (Followed  B.y  20 
Numbered  Lines  of  Comments,  Then:)  THE  FOLLOWING  COMMENT 
CAUSED  Overflow  OF  CMENT  ARRAY:  (Followed  by  a  21st 
Comment  Line). 


The  corrective  action  is  either  to  reduce  the  number  of  comments 
for  the  case  or  increase  the  second  dimension  of  the  CMENT  array. 

Note:  One  possible  cause  of  too  many  comments  is  the  omission 
of  one  or  more  END  cards. 

This  message  corresponds  to  the  STOP  of  section  7.5.1. 

7.4.3  INPUT  ATTEMPTED  TO  READ  RECORD  NAMED  Record  Name 
BUT  NO  SUCH  RECORD  WAS  FOUND. 

The  record  name  is  the  name  of  the  record  which  the  program 
attempted  to  read  from  the  word  addressible  mass  storage  file  but  which 
could  not  be  found  on  that  file. 

This  message  means  the  desired  record  does  not  exist  on  the 
mass  storage  file.  In  order  to  create  it,  one  of  the  pre-processor 
programs  must  be  run.  If  the  OVERRIOE  feature  was  used,  try  preceding 
the  record  name  with  a  $  (dollar  sign),  as  described  in  section  4.5.3. 

This  message  is  accompanied  by  a  trace  back  print  of  the 
subroutines  called  to  produce  the  message.  This  can  be  used  to  locate 
which  call  to  READMS  actually  caused  the  abnormal  termination. 

This  message  occurs  with  the  STOP  in  section  7.5.21. 

7.4.4  IN  FINDIT.  KEYWORD:  Keyword  AND  CORRESPONDING  VALUE 

OF  IT:  Value  ARE  NOT  ALLOWED  WITH  THE  Option  Word  OPTION. 

Here  keyword  is  the  keyword  character  string,  value  is  the 
keyword  number,  and  option  word  is  an  option  word  character  string. 

This  message  occurs  when  one  attempts  to  use  OVERRIDE,  TEMPORARY, 
or  RESET  features  with  an  option  word  that  is  a  keyword  other  than  the 
name  of  one  of  the  data  blocks. 

This  message  corresponds  to  the  STOP  of  section  7.5.5. 

7.4.5  IN  FINDIT.  NO  MATCH  FOUND  FOR  LINE  IB*  nnn  OF  THIS  B 
ARRAY:  (Followed  By  Up  to  10  Lines  of  Character  Strings). 

Here  nnn  is  the  value  of  IB. 
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IB  is  the  number  of  the  character  string  for  which  no  match  wa s 
found.  If  16=1,  there  was  no  keyword  match  (this  corresponds  to  the  stop 
of  section  7.5.4).  If  IB=2,  then  one  could  be  in  the  situation  of  the 
STOP  of  section  7.5.4,  section  7.5.6  or  section  7.5.7. 

This  error  usually  means  the  keyword  or  option  word  found  in 
line  IB  was  misspelled  or  does  not  exist. 

7.4.6  IN  HUMRIC.  LINE  nnn  EXCEEDS  ALLOWABLE  FIELD  LENGTH 
FOR  NUMERIC  DATA:  (Followed  By  Up  to  10  Lines  of 
Character  Strings]/ 

Here  nnn  is  the  number  of  the  line  in  the  listing  of  character 
strings  which  contains  a  numerical  string  of  more  than  10  characters 
(including  sign  and  if  present). 

The  corrective  action  is  to  change  the  number  to  one  of  less 
than  10  characters  (when  including  and  ’'.").  With  the  parameters 
used  in  COPE  there  should  never  be  occasion  to  use  a  number  requiring 
more  than  10  characters. 

(Note:  If  the  number  is  written  on  input  without  a  decimal 
point,  then  the  program  adds  a  decimal  point  after  the  last  digit.  Hence, 
if  the  decimal  point  is  omitted  the  number  should  not  exceed  nine  characters). 

This  error  corresponds  to  the  STOP  of  section  7.5.23. 

7.4.7  IN  NUMRIC.  LINE  nnn  HAD  TOO  MANY  DECIMAL  POINTS: 

(followed  By  Up  To  10  Lines  of  Character  Strings). 

Here  nnn  is  the  number  of  the  line  in  the  listing  of  character 
strings  which  contains  more  than  one 

The  corrective  action  is  to  rewrite  the  input  line  so  that  no 
option  word  has  more  than  one  decimal  point. 

This  error  corresponds  to  the  STOP  of  section  7.5.22. 

7.4.8  IN  SMPLCD  WITH  RANDOM  NUMBER  GREATER  THAN  1.0  RN=xx. xxxxxxx. 


Here  xx.xxxxxx  is  the  random  number  generated  for  use  in  SMPLCD. 

This  error  will  occur  only  if  the  random  number  generator 
malfunctions  and  produces  a  number  1.0.  If  this  error  occurs,  a  trace 
of  subroutine  calls  is  produced  and  the  STOP  of  section  7.5.31  occurs. 

7.5  STOP  Messages  That  are  Printed  in  the  Dayfile. 

7.5.1  STOP  IN  COMMNT :  TOO  MANY  $$  COMMENTS.  This  message 
occurs  when  too  many  SS  comments  are  encountered  in  one  case.  See  section 

7.4.2. 
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7.5.2  STOP  IN  COPE:  NORMAL  PROGRAM  TERMINATION.  This  is  the 
desirable  stop  message.  !t  means  that  the  program  terminated  after 
processing  all  the  inputs  and  that  no  abnormal  stopping  conditions  were 
encountered.  Of  course,  it  does  not  guarantee  that  the  program  did  what 
the  user  expected,  an^  there  may  be  some  warning  diagnostic  messages  (of 
types  1,  2,  or  3  above)  produced. 

7.5.3  STOP  IN  DFCHK:  ERROR  NUMBER  1.  This  stop  occurs  when 
the  desi gnator-to-target  range  cannot  be  bracketed  by  the  range  values  in 
the  DFFOKL  array.  This  indicates  either  an  error  in  the  range  calculation 
or  a  need  for  larger  range  values  in  the  DFFOKL  array. 

7.5.4  STOP  IN  FIND  IT:  ERROR  NUMBER  1.  This  message  means  that 
a  search  of  the  CHAR  array  has  found  no  keyword  to  match  that  of  the 
current  input  card.  (If  the  OVERRIDE,  TEMPORARY,  or  RESET  option  is 
used,  then  this  message  will  also  occur  if  the  second  character  string  on 
the  card  cannot  be  matched  from  the  CHAR  array). 

This  stop  corresponds  to  the  print-out  of  section  7.4.5. 

7.5.5  STOP  IN  FIND IT :  ERROR  NUMBER  2.  This  message  occurs 
when  one  attempts  to  use  the  OVERRIDE,  TEMPORARY,  or  RESET  option  with 
anything  other  than  one  of  the  eight  data  block  names.  (See  section  4.5.) 

See  section  / . 4 . 4. 

7.5.6  STOP  IN  FINDIT:  ERROR  NUMBER  3.  This  message  occurs 

v/hen  no  match  for  a  given  option  word  from  an  input  card  can  be  found 
among  the  allowable  option  words  for  the  input  card's  keyword. 

See  section  7.4.5. 

7.5.7  STOP  IN  FINDIT:  ERROR  NUMBER  4.  This  message  means  the 

same  as  that  in  T.T.6,  but  occurs  at  a  different  point  in  subroutine  FI  NO  IT. 

7.5.8  STOP  IN  FPRCNT :  ERROR  NUMBER  I.  This  message  means  that 

function  FPRCNT  was  called  to  format  into  a  percentage  a  number  greater  than 
or  equal  to  100.05.  There  should  never  be  any  percentages  greater  than  100 
in  this  program,  so  if  this  message  is  obtained,  there  are  major  problems 

in  the  bookkeeping  processes.  In  particular,  the  NAI30RT  array  and  NTEST 
array  are  probably  filled  with  wrong  numbers. 

7.5.9  STOP  IN  GETRNG:  TARGET  VELOCITY  =  0.0.  This  message  means 
a  target  velocity  of  zero  was  input,  this  is  not  allowed  since  division 

by  zero  in  calculating  1 i ne-of-sight  duration  would  cause  division  overflow 
on  the  computer. 

If  one  really  wishes  to  use  zero  velocity,  it  is  suggested  that 
one  use  a  velocity  of,  say,  .001  which  will  create  1 ine-of-s ight  durations 
so  great  that  the  end  result  will  not  differ  sigrii  ficantly  from  those  of 
a  stationary  target. 

A  subroutine  call  trace  is  also  produced. 
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7.5.10  STOP  IN  GETVIS:  RANDOM  NUMBER  TROUBLE  1 .  This  message 

means  that  the  attempt  to  sample  weather  data  failed  under  cloud  free 

line-of-sight  conditions. 

This  probably  means  that  there  is  an  error  in  the  PRGCFL  array 
or  the  random  number  generator  is  malfunctioning. 

A  subroutine  call  trace  is  also  produced. 

7.5.11  STOP  IN  GETVIS:  RANDOM  NUMBER  TROUBLE  2.  This  message 

means  that  the  attempt  to  sample  weather  data  failed  under  no  cloud  free 

line-of-sight  conditions. 

This  probably  implies  that  there  are  invalid  numbers  in  the  W 
array  or  the  random  number  generator  is  malfunctioning. 

A  subroutine  call  trace  is  also  produced.  - 

7.5.12  STOP  IN  HEADER:  ERROR  NUMBER  1.  This  error  occurs  only 
if  IOVER  (J)  has  a  value  other  than  0,  1 ,  or  2  for  a  value  of  J  =  21,  22, 
23,  24,  25,  2G,  27,  or  28. 

This  should  never  happen.  If  it  does  there  is  a  serious  problem 
somewhere  in  the  input  or  the  random  access  mass  storage  file. 

7.5.13  STOP  IN  HITCHK:  FAILED  TO  BRACKET  RANGE.  This  stop 
occurs  when  the  desi gnator-to-target  range  cannot  be  bracketed  by  the 
range  values  in  the  RNGPST  array.  This  indicates  either  an  error  in  the 
range  calculation  or  a  need  for  longer  range  values  in  the  RNGTTF  array. 

7.5.14  STOP  IN  INPUT:  EOF  ENCOUNTERED.  This  stop  occurs  when 
an  end-of-file  is  encountered  on  TAPE  5  after  an  END  card  (instead  of 
after  the  expected  ENDF  card). 

7.5.15  STOP  IN  INPUT:  ERROR  NUMBER  1.  This  stop  corresponds 
to  the  message  of  section  7.4.1. 

7.5.16  STOP  IN  INPUT:  EXTRA  NEXT  CASE  CARD.  This  stop  occurs 
when  two  (or  more)  NEXT  CASE  cards  occur  within  the  same  case  (i.e. , 
without  an  intervening  END  card).  The  program  will  not  accept  more  than 
one  NEXT  CASE  card  per  case.  (All  cards  lying  between  consecutive  END 
cards  are  considered  to  form  a  case.  For  this  purpose,  the  beginning  and 
end  of  TAPE  5  may  both  be  regarded  as  END  cards.) 

7.5.17  STOP  IN  INPUT:  FIRST  CASE  CARD  IN  SUBSEQUENT  CASE.  This 
stop  occurs  if  a  FIRST  CASE  card  is  encountered  anywhere  on  TAPE  5  other 
than  in  the  first  case.  Cases  other  than  the  first  case  should  be  headed 
by  NEXT  CASE  cards  rather  than  FIRST  CASE  cards. 
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7.5.18  STOP  IN  INPUT:  PARAMETERIZED  RESPONSE  TIME  <=O.Q.  This 
stop  occurs  when  attempting  to  play  a  parameterized  response  time  less 
than  or  equal  to  cero.  Such  times  are  not  allowed  in  the  program. 

7.5.19  STOP  IN  LOSCHK:  ERROR  WITH  RANDOM  OCCURRENCE  OPTION.  This 
message  means  that  the  designator-to-target  range  cannot  be  bracketed  by 
the  range  value  in  the  RNGPLS  array.  This  indicates  either  an  error  in 

the  range  calculation  or  a  need  for  larger  range  values  in  the  RNGPLS  array. 

7.5.20  STOP  IN  MINTRN:  FAILED  TO  BRACKET  RANGE.  This  stop 
occurs  when  the  desi gnator-to-target  range  cannot  be  bracketed  by  the 
range  values  in  the  RNGPST  array.  This  indicates  either  an  error  in  the 
range  calculation  or  a  need  for  larger  range  values  in  the  RNGPST  array. 

7.5.21  STOP  IN  NOREC:  ATTEMPTED  TQ  READ  NON  EXISTENT  RECORD.  This 
stop  corresponds  to  the  message  of  section  7.4.3. 

A  subroutine  call  trace  is  also  produced. 

7.5.22  STOP  IN  NUMRIC:  ERROR  NUMBER  1.  This  stop  corresponds 
to  the  error  message  of  section  7.4.7. 

7.5.23  STOP  IN  NUMRIC:  ERROR  NUMBER  2.  This  stop  corresponds 
to  the  error  message  of  section  7.4.6. 

7.5.24  STOP  IN  PECHK:  FAILED  TO  BRACKET  DELTA  T.  This  message 
means  that  the  time  delay  cannot  be  bracketed  by  the  DLTT  array  time 
values.  This  indicates  either  an  error  in  calculating  DELTAT  or  a  need 
for  larger  time  values  in  the  DLTT  array. 

7.5.25  STOP  IN  RENAME:  ERROR  NUMBER  1.  This  stop  means  that 
one  of  the  input  values  that  determines  which  PCDATA  record  is  to  be  used 
had  a  value  not  found  in  the  XVALUE  array.  (See  section  5.4.) 

7.5.26  STOP  IN  PENAME:  ERROR  NUMBER  2.  This  stop  means  that 
an  illegal  index  value  was  assigned  to  NP  in  subroutine  PENAME.  (See 
section  5.4.) 


7.5.27  STOP  IN  PENAME:  ERROR  NUMBER  3.  This  stop  means  that  a 
response  time  less  than  zero  or  greater  than  or  equal  to  999.5  was  input. 
This  is  outside  the  allowable  range  of  response  times. 

7.5.28  STOP  IN  PENAME:  (PEIDNT)  ERROR  NUMBER  4.  This  stop 
means  that  the  PEDATA  record  name  could  not  be  decoded  successfully. 

(See  section  5.4.) 


7.5.29  STOP  IN  SEPREC:  ERROR  NUMBER  1.  This  error  occurs  only 
if  the  number  of  keywords  and/or  option  words  on  an  input  card  is  greater 
than  10  or  less  than  or  equal  to  zero. 
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7.5.30  STOP  IN  SMPLCD :  FAILED  TO  BRACKET  RANDOM  NUMBER.  This 
stop  occurs  when  the  random  number  obtained  from  the  uniform  random  number 
(0  to  1)  generator  cannot  be  bracketed  by  the  cumulative  probability 
values  describing  the  distribution  to  be  sampled.  It  indicates  either  a 
malfunctioning  random  number  generator  or  an  incomplete  description  of 
the  distribution  to  be  sampled. 

A  subroutine  call  trace  is  also  produced. 

7.5.31  STOP  IN  SMPLCD:  RANDOM  HUMBER  TOO  LARGE.  This  stop 
corresponds  to  the  error  message  of  section  7.4.8. 

A  subroutine  call  trace  is  also  produced. 

7.6  Echo  Printing. 

The  COPE  program  uses  TAPE  8  (i.e.,  logical  output  unit  8)  to 
echo  inputs,  to  print  the  values  of  the  case  parameters,  and  to  print  the 
initial  random  number  seeds.  TAPE  8  is  normally  a  scratch  file  that  is 
lost  when  the  job  is  completed;  however,  if  one  wishes  to  see  the  contents 
of  TAPE  8  for  debugging  or  verification  purposes,  then  one  need  merely 
list  it  or  catalog  it  for  future  reference. 

A  sample  of  TAPE  8  contents  is  shown  in  Listings  7-1  and  7-2. 

For  each  case  that  is  run  there  are  two  sections  of  output  on 
TAPE  8.  The  first  section  is  a  listing  of  the  input  options  (i.e.,  the 
case  descriptor  cards  on  TAPE  5)  that  apply  to  the  case. 

The  second  section  (Data  Check)  displays  the  values  of  most  of 
the  data  that  describe  the  case.  This  section  includes  data  from  the 
word  addressable  mass  storage  file  (or  its  equivalent  obtained  by  using 
the  TEMPORARY  option),  data  obtained  directly  from  INPUT  cards,  and  a  few 
computed  values.  Together,  these  data  give  the  complete  numerical 
description  of  the  case  to  be  simulated.  (This  echo  print  data  check  has 
two  forms,  a  long  form  and  a  short  form.  The  long  form  gives  all  of  the 
data  describing  the  case;  the  short  form  gives  it  dll  except  the  PEDATA 
(i.e.,  the  INDEX  and  PETBL  arrays).  (See  section  4.4.6.) 

Listing  7-1  gives  an  example  of  what  is  printed  on  TAPE  8 
when  the  short  form  of  the  echo  print  is  used.  Listing  7-2  shows 
the  TAPE  8  printout  when  the  echo  print  long  form  is  used. 

The  values  listed  in  the  Data  Check  section  of  the  TAPE  8 
printout  are  not  identified  by  any  printout  labeling.  Instead,  the  user 
must  locate  the  value  of  a  particular  variable  on  the  printout  by  matching 
the  printout  lines  with  the  WRITE  statements  in  subroutine  ECHO.  If  the 
user  intends  to  use  this  Data  Check  section  frequently,  then  perhaps  some 
labeling  should  be  added. 


In  addition  to  the  two  sections  of  output  for  each  case,  TAPE  8 
also  includes  the  random  number  seeds.  These  are  printed  immediately 
following  the  first  case  data  check.  Since  the  randan  number  seeds  used 
for  each  case  are  the  same,  the  print  of  random  number  seeds  is  not 
repeated  following  the  data  check  prints  for  subsequent  cases. 


Note  that  the  column  numbers  at  the  top  and  bottom  of  each  page 
of  Listings  7-1  and  7-2  are  not  part  of  the  output  produced  on  TAPE  8. 
They  are  included  here  only  for  the  reader's  convenience. 
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CHAPTER  8 


8.  PROGRAM  DESIGN 

8.1  Programming  Principles  of  COPE. 

The  main  COPE  program  has  been  designed  according  to  the  following 
principles: 

(1)  Input  is  designed  to  allow  multiple  cases  per  run  with  only  a 
few  mnemonically  keyed  input  lines  per  case.  For  flexibility, 
it  is  also  possible  to  read  in  data  as  traditional  FORTRAN 
formatted  input. 

(2)  Output  is  designed  so  that  the  printout  of  results  is  nearly 
self-explanatory.  In  addition,  user  generated  comments  can  easily 
be  made  to  appear  in  the  printout  for  any  case. 

(3)  The  program  is  highly  modularized.  The  main  program  consists 
almost  entirely  of  calls  to  various  subroutines  together  with 
the  logic  necessary  to  initialize  and  control  the  execution  of 
three  nested  loops  (see  section  8.2). 

(4)  Most  subroutines  or  functions  are  designed  for  a  single  purpose 
(e.g. ,  perform  a  test,  read  input,  write  output,  etc.)  so  that 
when  one  wishes  to  change  any  aspect  of  the  program  it  is  usually 
necessary  to  change  only  a  small  number  of  the  subroutines 
(usually  the  one  performing  a  particular  test  plus  the  input 
routine). 

(5)  The  principles  of  structured  programming  have  been  adhered  to 
in  some  degree.  Because  the  program  is  written  in  FORTRAN  IV 
(extended  CDC  version)  which  does  not  have  if-then-el se,  do-until, 
do-while  constructs,  it  is  still  necessary  to  use  GO  TO's  and 
statement  labels.  However,  blank  comment  cards  have  been  in¬ 
serted  between  logical  blocks  within  each  program  to  improve 
readability,  and  unnecessary  GO  TO's  have  been  minimized.  In 
addition,  statement  labels  are  in  ascending  numerical  order 
within  each  subroutine. 

(6)  All  data  statements  have  been  grouped  into  a  single  BLOCK  DATA 
subprogram. 

(7)  Mnemonically  meaningful  variable  and  subroutine  names  have  been 
selected. 

(8)  FORTRAN  code  has  been  written  to  minimize  the  number  of  non¬ 
standard  (i.e. ,  CDC  peculiar)  features  used.  Nevertheless, 
there  are  some  CDC  peculiar  code  features  that  were  impractical 
to  omit  (e.g.,  READMS,  SYSTEMC,  etc.).  These  are  cited  in 
Chapter  13. 


8.2  General  Logic  Flow. 

The  COPE  main  program  can  be  viewed  as  three  large  nested 
loops  on  case,  replication,  and  round.  Figure  8-1  illustrates  the 
general  COPE  logic  flow  including  the  three  loops. 

This  figure  is  necessarily  oversimplified  and  a  more  detailed 
flow  chart  is  to  be  found  in  Chapter  11,  but  the  overall  picture  is 
accurately  summed  up  here. 

8.3  Subroutine  and  Function  Calling. 

Table  8-2  gives  a  listing  of  the  names  of  the  main  program, 
all  of  the  subroutines,  and  all  of  the  functions  in  the  COPE  program. 

COpE  is  the  main  program  name. 

FPRCNT ,  GAMMA,  IDCHAR,  NUMRIC,  and  UR AN 31  are  the  function 

names. 


AGRTTL ,  ADDTBR,  AODTOF ,  ARTCHK ,  BLOCIIK,  CCPLOT,  COMMNT, 

CREAO,  OETCTN,  DFAULT,  DFCHK,  DUST,  ECHO,  FINDIT,  GETRNG,  GETTIM, 

GETVIS,  HEADER,  HITCHK,  INITLZ,  INPUT,  LOSCHK,  MINTRN,  NOREC,  OUTPUT, 
PECHK,  PE NAME,  PKCHK,  PPLOT,  PSMOKE,  REINTZ,  RNDREL,  RNGCHK,  SEPREC, 
SMOKC,  SMPLCD,  TIMCHK,  TITLE,  USET,  VISCHK,  and  WARNFO  are  the  subroutine 
names. 


PEIDNT  is  an  entry  point  name  in  subroutine  RENAME. 

For  each  list  entry  (subprogram  name)  in  Table  8-2,  there 
are  sections  giving  the  names  of  subprograms  calling  the  given  list 
entry,  the  names  of  subprograms  (in  COPC)  that  the  given  list  entry 
calls,  and  the  names  of  system  or  IMSL  routines  that  the  given  list 
entry  calls. 

There  is  a  discrepany  that  occurs  in  the  list.  Subroutine 
NOREC  is  called  by  system  routines  LOCF  (as  an  external  argument)  and 
SYSTEMC  (by  address  loaded  in  IRAY  array)  and  hence  does  not  show  as 
"CALLED  BY"  any  routine  in  Figure  8-2  (see  section  9.31). 

Table  8-3  lists  the  system  (CDC,  standard  FORTRAN,  and 
International  Mathematical  and  Statistical  Library)  routines  used  in 
COPE  and  the  subprograms  of  COPE  that  call  each  of  them. 

Table  8-4  is  a  subprogram  calling  tree.  Each  subprogram 
(subroutine  or  function)  in  column  two  can  be  called  by  the  COPE  main 
program  directly.  Each  subprogram  in  column  N  calls  those  subprograms 
in  column  N+l  to  which  it  is  linked  by  lines  (V's,  I's,  -’s,  and  >'s). 

NOREC  calls  no  other  subprograms  in  COPE.  It  is  called  by 
SYSTEMC  whenever  CDC  FORTRAN  IV  Extended  execution  error  104  is  en¬ 
countered  in  INPUT,  INITLZ,  or  FINDIT. 
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TABLE  8-2  PROGRAM  UNIT  REFERENCES  (SUBROUTINES,  FUNCTIONS,  AND  MAIN  PROGRAM) 
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TABLE  8-2  PROGRAM  UNIT  REFERENCES  (SUBROUTINES,  FUNCTIONS,  AND  MAIN  PROGRAM)  -  CONT'D 
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i nr hap 

CALLED 

BY 

NUMRIC 

SEPREC 

I N  IT  L  7 

CALLED 

BY 

COPE 

CALL  S 

nr ault 

USFT 

CALI  5 

(  s  Y  S  ) 

1.  OCF 

QPENMS 

READMS 

SYSTEMC 

INPi’T 

CALLED 

BY 

COPE. 

CALLS 

CCPLOT 

COMMNT 

CREAD 

ECHO 

FINDIT 

HFADER 

RENAME 

PPLOT 

PSMOKE 

SEPREC 

USFT 

CALLS 

(SYS) 

ABS 

DECODE 

ENCODE 

EOF 

FLOAT 

LOOP 

READMS 

READ 

SYSTEMC 

WRITE 

i.  OSCHK 

CALLED 

BY 

COPE 

CALLS 

aerttl 

URAN31 

CALLS 

(SYS) 

AM  AX  1 

MINTRN 

CALLED 

BY 

COPE 

CAI  LS 

ABRTTL 

UR AN 3 1 

CALLS 

(SYS) 

AM  AX  1 

NOREC 

CALLED 

EY 

CALLS 

(SYS) 

S TRACE 

WRITE 

NUMRIC 

CALLED 

BY 

FIND  IT 

CALLS 

TDCHAR 

CALLS 

(SYS) 

DECODE 

ENCODE 

WRITE 

OUTPUT 

CALLE  D 

BY 

COPE 

CALLS 

FPRCNT 

CALLS 

(SYS) 

FLOAT 

WRITE 

PECHK 

CALLED 

BY 

COPE 

CALLS 

ABRTTL 

URAN3  1 

CALLS 

(SYS) 

AM  AX  1 

FLOAT 

MAXI? 

MINI? 

MINI 

PF IDNT 

CALLED 

EY 

HEADER 

CALLS 

(SYS) 

ABS 

DECODE 

FLOAT 

MOD 

PE  NAITE 

CALLED 

BY 

INPUT 

C  LLS 

( S  Y  ?. ) 

AES 

ENCODE 
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PKCHK 

CALLED  BY 

CALLS 

CALLS  (SYS) 

COPE 

ABRTTI. 

M I OA 

URAN3 1 

PPLOT 

CALLED  BY 
CALLS 

CALLS  (SYS) 

INPUT 

COMMNT 

ENCOril 

PS MOKE 

CALLED  BY 
CALLS  (SYS) 

INPUT 

AMtNl 

FLOAT 

REINT2 

CALLED  BY 
CALLS  (SYS) 

COPE 

MOD 

WRITE 

RNDREL 

CALLED  E'Y 
CALI.  S 

COPE 

ABRTTL 

URAN31 

RNCCHK 

CALI  F D  BY 
CALLS 

COPE 

ABRTTL 

SEPREC 

CALLED  BY 
CALLS 

CALLS  (SYS) 

CREAD 

COMMNT 

ENCODE 

1  NPUT 
1DCHAR 

SMOKE 

CALLED  BY 
CALLS 

COPE 

ABRTTL 

UR AN 3 1 

SMPI.CD 

CALLED  BY 
CALLS 

CALLS  (SYS) 

DFTCTN 

URAN31 

STRACE 

GETRNG 

WRITE 

GETTTM 

TIMCHK 

CALLED  BY 
CALLS 

COPE 

ABRTTL 

TITLE 

CALLED  BY 
CALLS  (SYS) 

COPE 

DATE 

TIME 

WRITE 

URAN31 

CALLED  BY 

ARTCHK 

l.QSCMK 

SMPLCD 

DFCHK 

MINTRN 

WARNDO 

DUST 

PECHK 

GETTIM 

PKCHK 

GETV1S  HIT  C HK 
RNDREL  SMOKE 

USET 

CALLED  BY 

INITL2 

INPUT 

VISCHK 

CALLED  BY 
CALLS 

COPE 

ABRTTL 

WARNDO 


CALLED  £ Y 
CAi  I  S 


COPE 

OPRTTl.  l  IP  AN 
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AES 

CAl  l  ED 

PY 

INPUT 

REI.DNT 

FT  NAME 

AMAX  1 

CAL  LED 

EY 

DF  CHU 

L.  OSCHK 

MTNTRN 

PEC  UK 

AMTN1 

CALLED 

PY 

RSMOKE 

DATE 

CALLED 

EY 

TITLE 

DEI  ODE 

f  Al  l  ED 

BY 

CPE  AD 

Hi"  ADER 

INPUT 

Nl.lfTF;  I C 

PF  I IJNT 

r  n  :onr 

CALL  ED 

PY 

CCPLOT 

NKMRIC 

CO MM NT 

RENAME 

t  R  F  >  * ,  ‘ 
F'PLO  r 

F  CM  1 

seprfx 

NFADF R 

INPUT 

EOF 

CALI  ED 

EY 

INPUT 

FLOAT 

CAL L 1  0 

PY 

ii|  TEND 

INPUT 

OUTPUT 

PRC  HP 

F"  IDlvT 

PbMOKK 

GO  A  IT  A 

CAl.  L  ED 

PY 

GAMMA 

3  F  I  X 

CALI  ED 

PY 

F I ND  !  T 

LOOP 

CAl.  1  ED 

P  Y 

1  I  ND  I  T 

?  NTTL.7 

INI 'LIT 

MAX  1? 

CALLED 

BY 

PF  r  Ml: 

IT  I  NO 

CAl  L  r  P 

BY 

PE  HP 

f?|  r  i  if 

M  T.  N  1. 

CALLED 

BY 

PET  HK 

MOD 

r  AI..I  f  D 

BY 

FEIDNT 

RE  I NT 7 

ORE  NITS 

CALLED 

PY 

IM.TL7 

REALMS 

CALI  FD 

P'- 

F  TND’,  T 

1  N 1  Tl.7. 

INF  NT 

READ 

CAl  L  ED 

PY 

f  READ 

1  NPHT 

ST RACE 

CALLED 

L  Y 

AFT  KMC 

GET  V I S 

WOREi . 

SMF'LCD 

sr STEMS 

CALI  ED 

PY 

FIND  IT 

I  NT  TL  7 

I  WO. IT 

TIME 

CALI. ED 

BY 

T  I  T  L  E 

WRITE 

CALL  El; 

DY 

COMM  IT  T 
WHITE:  I  c 

F  CHO 
nu  'Pi:t 

F  INPU  T 
EE  INTO 

HEADER 

CM PL  CD 

T  NPHT 

T  T  T  |.  t 

MOREL 

NOTE:  ALL 

ROUTINE 

S  LI 

•  TFT  IN  ' 

HE  FIRST 

CEL  I IMN 

OF  THIS 

TAEL  E 

EXCEPT  CGAMA )  API  STANDARD  SYSTEM  ROUTINES  OF  C  DO 
FORTRAN  EX  TfNDEF)  VERSION  -T  . 

GGAMA  IS  A  SUERO’IT  INF.  FROM  THE  INTERNATIONAL  MATHEMATICAL 
AND  ST  AT  T  ST I  CAL  LIBRARY  ( I  MCI  )  . 


TABLE  8-4  COPE  SUBROUTINE  "TREE 


OPC-  - . >  A  0  D  T  B  R 

I  -  - . . '  ADDT  OF 


I -  ARTCHk-  .  -  -  1ABRTTI. 


V1 

r- 

- 

HIEAN31 

T 

BLOCMt-  •  - 

- 

ABPTTL 

T 

:  PETf  1 N  - 

•ADRTTI. 

V 

1  - 

- 

•OMPLCD 

I  ■  '•  " 

DP  CHI'  -  - 

>  ADRTTI. 

V 

I  •  - 

1  IRAN'S  1. 

■ . . 

rntPT  -  - 

.  ADRTTL 

V- 

I  - 

- 

>  UR  AN  - 3  i 

I  -  -  - . 

OH  TRNO  - 

SMF'I.  CD 

y . - 

c,£T  riM- 

;  ADRTTI. 

t « 

r  - 

- 

GAMMA 

V 

i- 

- 

SNPi.Cn 

V 

i  - 

- 

;  UR  AN3 1. 

T .  _ 

■CFTVIS-- 

- 

UR  AN  '  5 

T . .  .  ..  .  ... 

•EITOMK- - 

- 

‘ADRTTI. 

\J 

T  - 

- 

•  - 

> UR ANSI 

I  -  - . 

- 

>D FAULT 

V 

I  - 

- 

- 

>USET 

1  -  - - 

:>  INPUT-  -  - 

ccpi.  or 

V 

f  -  - 

- 

-  • 

>C OMMNT 

y 

1  - 

- 

- 

1  CPE AD- 

V 

V 

V 

i  -  • 

- 

•ECHO 

C 

l-  •• 

p?wd;t 

'J 

I  -  - 

HEADER 

V 

I .... 

-  . 

RENAME 

V 

I-  - 

: PPL OT- 

«.» 

I-  •• 

. 

>  PS  MOKE. 

V 

I  -  - 

- 

>SEFREC 

V 

V 

V 

T  -  - 

>USFT 

I  -  -  - . 

T.  OSCHK-  • 

ADRTTI. 

v 

1  - 

- 

-- 

MJRAN3  1 

1  -  - . 

•mintrn- 

>ABRTT! 

V 

T 

i 

‘UR ANSI 

r - - 

■  OUTPUT  - 

- 

>EPRCNT 

T _ _  .  ,  _ 

RFC UK - 

- 

>ADRTTL 

\ 

r 

l  -  - 

>URAN3 1 

r  . .  • 

PKCHK - 

- 

i'ABRTTL 

V 

1  - 

- 

>1.  IRAN  31 

T  •  -  -  ■  - 

•RE  I  NTT 

!  -  -  - - 

NNDREI  -- 

- 

--- 

-- 

:>abrttl 

y 

I  - 

-- 

> UR ANSI 

? -  .  .  .. 

ENCCHK- - 

- 

--- 

;>ADR1  Tl. 

T  ........  .  .  - 

•SMOKE - 

- 

-- 

TAERTTL 

V 

I~- 

>  UR  ANSI 

I - 

:  TIMCHK- - 

- 

1‘AERTTI. 

> - —  . 

>  T  I  t  i  r 

T  -  -  -  - . 

VTSOHK-- 

- 

>  AERTT 1. 

1 . -  -  - 

‘WAP.NPO-- 

- 

>ABRTTL. 

V 

I- 

- 

'UR ANSI 

> UR AN 31 


- - HIRAN31 

- > UK AN 01 


'•CHMMNT 

>SEPREC - - 

> COMM NT 

T _ 

L 

>  \  DCHAR 

>RIUMR  I C - 

>  T  DC HAR 

>COMMNT 

PE  I  ON  I 

-  - > COMM NT 

-  -  -COMM NT 

-  - > 1 DCHAR 


CHAPTER  9 


9.  SUBPROGRAMS 

This  chapter  explains  in  moderate  detail  what  each  subprogram 
of  COPE  does.  All  four  standard  FORTRAN  subprogram  types  (main  program, 
block  data,  function,  and  subroutine)  are  present  in  COPE.  In  the  following, 
the  subprograms  are  discussed  in  this  order:  main  program,  block  data, 
functions  (in  alphabetical  order),  and  subroutines  (in  alphabetical 
order). 


This  chapter  deals  only  with  subprograms  defined  by  COPE. 

System  subroutines  and  functions  are  divided  into  three  classes:  standard 
FORTRAN  IV  routines,  routines  peculiar  to  CDC  FORTRAN  4  Extended,  and 
IMSL  routines.  The  reader  is  assumed  to  be  familiar  with  the  first  of 
these  classes  (or  at  least  have  access  to  a  FORTRAN  manual).  System 
routines  in  the  remaining  two  classes  are  discussed  to  some  extent  in 
Chapter  13. 

9.1  COPE  Main  Program. 

The  COPE  main  program  is  well  summarized  by  the  flowchart  in 
Figure  8-1. 

The  main  program  begins  by  calling  routines  that  write  the 
title  page  (TITLE)  and  initialize  case  independent  variables  (INITLZ). 

Next  the  main  program  calls  INPUT  to  read  the  first  (or 
next)  case's  input.  It  then  calls  REINTZ  which  re-initial izes  certain 
case  dependent  counters  and  random  number  seeds.  It  then  initializes 
the  current  replication  number  at  one  and  the  number  of  FO's  (DO's) 
killed  so  far  in  the  case  at  zero.  The  steps  in  this  paragraph  begin 
the  "case  loop." 

The  main  program  next  begins  the  "replication  loop"  for  the 
first  (or  next)  replication  of  the  current  case.  This  loop  begins  by 
initializing  the  number  of  the  current  round  to  one  and  then  setting 
various  times,  flags,  and  a  counter. 

The  "replication  loop"  now  continues  by  calling  a  sequence 
of  subroutines  which  perform  the  tests  described  in  Chapter  2  and 
sample  weather,  range-LOS,  and  time  data. 
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routines  (in  order  called) 


ARTCHK 

perform  test  1 

GETV1S 

sample  weather  distribution 

GETRNG 

sample  acquisition  range  and 
LOS  segment  distributions 

V I SCHK 

perform  test  2 

RNGCHK 

perform  test  3 

DETCTN 

perform  test  4 

SMOKE 

perform  test  5 

DUST 

perform  test  6 

BLOCH  K 

perform  test  7 

uETTIM 

sample  time  distribution(s) 
and  perform  tests  8  and  9 

BLOCHK 

perform  test  10 

TIMCHK 

perform  test  11  (for  "shoot- 
ting  gallery"  only) 

ADDTOF 

calculate  round  arrival  time 

Cach  of  these  routines  is  explained  in  detail  later  in  this  chapter. 

Note  that  if  any  routine  that  performs  one  (or  more)  of  the 
tests  is  called  and  the  test  is  failed,  then  the  subsequent  routines  in 
the  above  list  are  not  called;  instead,  control  transfers  to  statement 
14?)  (end  of  "replication  loop")  where  a  check  is  made  to  determine  whether 
all  of  the  replications  for  this  case  have  been  done.  If  they  have, 

OUTPUT  is  called  to  print  case  results  and  then  the  end  of  the  "case 
loop"  is  either  hit  and  control  returns  to  statement  100  which  calls 
INPUT  to  read  the  input  for  the  next  case  or,  if  the  last  case  has  been 
run,  control  passes  to  the  STOP  and  the  program  terminates.  If  not  all 
replications  for  the  current  case  have  been  completed,  then  the  number 
of  the  current  replication  is  increased  by  one  and  control  returns  to 
statement  110  (which  is  the  start  of  the  "replication  loop")  to  begin 
next  replication. 

If  none  of  the  tests  are  failed  and  the  program  reaches  ADDTOF 
on  the  current  replication,  then  the  "round  loop"  begins  (with  statement 
120).  The  "round  loop"  consists  of  a  further  sequence  of  subroutines 
which  are  called  to  perform  those  tests  that  may  affect  only  one  round. 


routines(in  order  called) 

purpose 

L0SC!  IK 

perform  test 

12 

WARNF0 

perform  test 

13 

DFCHK 

perform  test 

14 

RNDREL 

perform  test 

15 

MINTRN 

perform  test 

16 

PECHK 

perform  test 

17 

HITCMK 

perform  test 

18 

PKCHK 

perform  test 

19 

Again,  each  of  these  routines 

is  explained  in  detai 1 

later  in  this 

chapter. 
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If  any  subroutine  that  performs  one  of  these  tests  (12  through 
19)  is  called  and  the  test  is  failed,  then  the  subsequent  routines  in 
the  above  list  are  not  called  for  the  current  round;  instead,  control 
transfers  to  statement  130  (end  of  "round  loop")  where  a  check  is  made 
to  determine  whether  all  of  the  rounds  for  this  replication  have  been 
done.  If  they  have,  control  transfers  to  statement  140  (end  of  "repli¬ 
cation  loop")  where  the  check  is  made  to  determine  whether  more  replications 
are  to  be  done  for  the  current  case.  If  not  all  rounds  for  this  replication 
have  been  completed,  then  the  time  the  next  round  arrives  is  computed 
(ADDTBR),  the  round  number  is  incremented  by  one,  the  end  replication 
(or  ENDREP)  flag  is  reset  and  control  transfers  to  statement  120  (start 
of  "round  loop")  to  begin  the  next  round. 

If  no  test  is  failed,  then  control  reaches  statement  130  after 
the  entire  sequence  of  subroutines  in  the  "round  loop"  has  been  called. 

At  this  point  a  check  is  made  to  determine  whether  all  rounds  for  this 
replication  have  been  done.  Control  then  proceeds  just  as  in  the  case 
when  statement  130  is  reached  due  to  a  failed  test  as  described  in  the 
paragraph  above. 

When  all  the  rounds  for  a  replication  are  completed,  a  check 
is  made  to  determine  whether  more  replications  remain  to  be  done  (end 
of  "replication  loop").  If  more  replications  remain,  control  transfers 
to  110  (start  of  "replication  loop")  to  begin  the  next  replication.  If 
all  replications  for  the  current  case  are  completed,  then  OUTPUT  is 
called  to  print  results  for  current  case  (end  of  "case  loop"). 

When  a  case  ends  and  its  results  are  printed,  the  proqram  checks 
whether  the  last  case  flag  (ENUFLG)  has  been  set.  If  it  has,  the  program 
stops;  if  it  has  not  been  set,  then  control  goes  to  statement  100  and 
INPUT  is  called  to  read  the  next  cases  input.  If  there  is  input  for 
another  case,  it  is  read  and  the  entire  process  from  INPUT  through  end  of 
"case  loop"  is  repeated;  if  there  is  no  input  for  further  cases,  the 
program  terminates. 

9.2  BDATA1  Block  Data  Subprogram. 

BDATA1  consists  entirely  of  data  statements  used  to 
initialize  variables  in  various  COMMON  blocks.  These  blocks  are 
listed  in  section  4.7  and  are  their  variables  defined  individually  in 
Chapter  12  (Glossary  of  Variables). 

9.3  FPRCNT  Function. 

This  function  formats  percentages.  It  takes  a  numerical 
argument  XIN  and  a  logical  argument  PAREN  and  assigns  a  one  word  al¬ 
phanumeric  character  string  as  the  value  of  FPRCNT. 

If  XIN  is  negative,  then  FPRCNT  is  assigned: 
the  left  justified  character  string  UNDEF ) ,  when  PAREN  is  true; 
the  right  justified  character  stri ng~NDEF ,  when  PAREN  is  false. 
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If  XIN  >  100.05,  a  STOP  occurs  with  an  error  message  (see 
section  7.5.7). 

If  XIN  is  positive  and  less  than  100.05,  then  FPRCNT  is 

assigned: 


a  left  justified  character  string  of  the  form  X.XX%), 

XX. XXX),  or  100.0%),  when  PAREN  is  true; 

a  right  justified  character  string  of  the  form  X.XX%, 
XX.XX%,  or  100.0%,  when  PAREN  is  false. 

The  character  strings  created  by  FPRCNT  are  used  by  OUTPUT 
to  print  percentages.  FPRCNT  is  called  only  from  OUTPUT. 

9.4  GAMMA  Function. 

This  function  takes  two  arguments,  one  real  parameter  ALPHA 
and  one  integer  IRN,  and  returns  a  real  value  as  GAMMA. 

ALPHA  is  the  a  -parameter  of  the  gamma  distribution's  prob¬ 
ability  density  function: 


9(x) 


1 

rxs) 


a-l 

X 


e 


-x 


GAMMA  is  assigned  a  value  obtained  by  randomly  sampling  from 
the  above  distribution.  This  sampling  is  accomplished  by  calling  the 
IMSL  subroutine  GGAMA  with  random  number  seed  IRN. 

The  function  GAMMA  itself  then  really  does  nothing  more  than 
dimension  two  arrays  required  by  GGAMA,  define  an  additional  variable 
used  by  GGAMA,  call  GGAMA  with  ALPHA,  IRN,  the  two  arrays  and  the 
additional  variable  as  arguments,  and  then  set  GAMMA  equal  to  the 
random  sample  obtained  by  GGAMA  from  the  gamma  distribution. 

9.5  IDCHAR  Function. 

The  IDCHAR  function  takes  three  arguments,  one  real  array  A 
and  two  integer  variables  N  and  I.  It  returns  an  integer  value. 

The  array  A  of  dimension  N  should  be  filled  with  left  jus¬ 
tified  characters,  one  character  per  word.  (Most  often  A  is  dimensioned 
with  N=80  and  consists  of  a  card  image  read  under  80A1  Format  in  INPUT). 
The  function  IDCHAR  then  examines  the  Ith  element  of  the  array,  that  is 

A(I). 


The  function  IDCHAR  is  then  assigned  a  value  as  follows: 


inCHAP.  = 
IDCHAR  = 
IDCHAR  = 
IDCHAR  = 
IDCHAR  = 

IDCHAR  = 
IDCHAR  = 


0  if  A(I)  is  a  number  or  minus  sign  (hyphen); 

1  if  A(I)  is  a  letter  or  an  apostrophe; 

2  if  A ( I )  is  a  decimal  point  (period); 

3  if  A(I)  is  a  blank; 

4  if  A( I)  is  a  separator  (i.e. ,  a  comma,  a  left  or 
right  parenthesis,  a  slash,  or  a  question  mark); 

5  if  A(I )  is  a  dol lar  sign;  and 
G  if  A(I)  is  anything  else. 


9.6  NUMRIC  Function  (Logical  Valued). 

The  NUMRIC  function  takes  one  real  array  argument,  B,  and 
three  integer  variable  arguments  Nl,  N2,  and  IB. 


The  array  B  of  dimension  Nl  by  N2  (i.e.,  DIMENSION  B(N1, 

N2))  is  checked  to  determine  whether  its  IBth  line  (that  is,  entries 
B(J,  IB)  for  J  =  1,  2,  3,...,  N2)  is  numeric  data  (i.e.,  whether  it 
consists  only  of  numerals,  minus  sign,  and  decimal  point  possibly  with 
trailing  blanks). 


If  the  line  is  numeric  data,  NUMRIC  is  assigned  the  value 
TRUE.  If  the  line  contains  some  non-numeric  characters  (letters, 
commas,  etc.),  then  NUMRIC  is  assigned  the  value  FALSE. 


The  IBth  line  of  the  B  array  is  treated  as  a  left  justified 
character  string  (10  characters  per  word)  which  is  examined  character 
by  character.  Only  the  first  80  characters  of  the  line  are  examined. 


When  the  line  being  checked  meets  certain  special  conditions, 
other  actions  may  be  taken:  If  more  than  one  decimal  point  is  encountered, 
an  error  stop  with  message  occurs.  If  no  decimal  point  is  encountered 
but  the  characters  are  otherwise  numeric  data,  then  a  decimal  point  is 
added  to  B  at  the  end  of  the  non-blank  characters,  NUMRIC  is  assigned 
the  value  TRUE,  and  a  return  occurs.  If  the  data  are  numeric  but  consist 
of  more  than  ten  non-blank  characters  (including  the  added  decimal 
point,  if  any),  then  an  error  stop  with  message  occurs.  If  the  data 
contain  imbedded  blanks,  then  checking  stops  at  the  first  imbedded  (i.e., 
non-trai 1 ing)  blank  and  the  program  behaves  as  though  every  character 
following  were  a  blank.  (This  should  have  no  effect  in  practice  since 
the  only  imbedded  blanks  occur  in  PEDATA  record  names  entered  with  the  $ 
preceding  them.  Those  names  will  already  have  failed  the  numeric  test 
before  ever  reaching  their  first  imbedded  blanks). 

9.7  URAN31  Function. 


This  function  takes  one  integer  argument  I  and  returns  a  real 
value  between  0  and  1  (exclusive). 


I 


This  is  the  "random"  number  generator  used  to  sample  most 
COPE  data  and  to  generate  "random"  numbers  to  be  compared  against 
probabilities  to  determine  whether  various  tests  are  passed. 

The  best  results  are  obtained  when  I  is  an  odd  integer  in 
the  range  from  0  to  67108864.  URAN31  generates  a  sequence  of  "random" 
numbers  by  replacing  I  by  3125*1 (MOD  67108864)  and  then  setting  URAN31 
equal  to  I  divided  by  67108864.  (That  is,  a  linear  congruential  type 
random  number  generator  A(N+1)  =  A(N)*B(M0D  C)  where  B  =  3125  and  C  = 

2**26).  Then  repeating  the  process  with  the  new  value  of  I  gives  the 
next  "random"  number. 

The  function  is  written  so  that  overflow  will  not  occur  even 
on  machines  with  a  word  size  as  small  as  32  bits. 

Normally,  one  would  not  define  the  random  number  generator 
explicitly  in  the  program  code  since  one  is  available  on  nearly  every 
computer  as  a  standard  system  function.  However,  because  users  on  other 
machines  may  wish  to  run  the  sample  cases  (see  appendices)  to  check  for 
correct  implementation,  the  URAN31  function  has  been  built  into  COPE  as 
its  standard  (system  independent)  random  number  generator. 

9.8  ABRTTL  Subroutine. 

This  subroutine  takes  the  integer  argument  IABRT  which  is 
the  number  of  the  test  whose  failure  caused  ABRTTL  to  be  called. 

ABRTTL  updates  the  test  abort  total  array  NABORT  by  increasing 
the  proper  entry  of  the  NABORT  array  by  one.  For  mission  aborts,  the 
elements  corresponding  to  all  rounds  of  the  IABRTth  test  are  increased; 
for  round  aborts,  only  the  element  corresponding  to  the  IABRTth  test  and 
current  (KRFth)  round  is  increased. 

In  addition,  the  flag  ENDREP  is  set  to  TRUE  to  indicate  that 
a  test  has  been  failed  and  the  current  replication  (or  round)  need  not 
continue  through  the  subsequent  tests. 

9.9  ADDTBR  Subroutine. 

This  subroutine  adds  TBR  (time  between  rounds)  to  TIMRA  (time 
round  arrived)  to  obtain  the  new  value  for  TIMRA  (time  next  round  arrives). 

9.10  ADDTOF  Subroutine. 

This  subroutine  adds  TOF  (time  of  flight)  to  TIMNOW  (time  gun 
is  ready  to  fire  Copperhead)  to  obtain  the  TIMRA  (time  first  round  arrives). 

9.11  ARTCHK  Subroutine. 

This  subroutine  performs  the  test  to  determine  whether  the 
F0  (or  DO,  designator  operator)  has  been  killed  or  suppressed  by  RED 
preparatory  artillery  fires  on  this  replication. 
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9.12  BLOCHK  Subroutine. 


This  subroutine  performs  the  bail  out  checks  (tests  7  and 

10). 

9.13  CCPLOT  Subroutine. 

This  subroutine  would  produce  a  Cal-Comp  plot  of  case  results, 
if  implemented.  At  the  present  time  it  merely  produces  a  comment  that 
no  plot  was  produced  for  the  case. 

9.14  COMMNT  Subroutine. 

This  subroutine  takes  four  arguments:  one  real  array  A  contain¬ 
ing  the  character  string  that  is  the  comment,  one  integer  N1  which  is 
the  dimension  of  A,  and  two  logical  flags  that  indicate  whether  the 
comment  is  a  user  comment  and  whether  the  comment  is  a  program  generated 
"$$$"  comment. 

The  subroutine  writes  the  comment  immediately  (along  with  a 
"$$$"  comment  page  heading,  if  needed)  if  the  comment  is  a  "$$$"  comment 
(either  user  or  program  generated).  If  the  comment  is  a  "$$"  comment, 
then  it  is  encoded  into  the  CMENT  array  for  later  printing  with  the 
current  case.  If  the  comment  is  a  "$"  comment,  it  is  ignored  and  a 
return  occurs. 

Note  that  user  comments  are  in  format  80A1  with  DIMENSION  A 
(80)  whereas  program  generated  comments  are  in  format  8A10  with 
DIMENSION  A(10).  This  difference  need  not  concern  the  casual  user, 
but  is  required  knowledge  if  one  is  to  modify  the  program  in  so  far  as 
comments  are  concerned. 

9.15  CREAD  Subroutine. 

This  subroutine  is  called  by  INPUT  whenever  the  user  exercises 
the  temporary  option.  The  second  field  on  the  TEMPORARY  card  will  be 
used  by  subroutine  INPUT  to  set  the  value  of  IT2  equal  to  the  keyword 
number  for  which  the  temporary  option  is  being  used. 

CREAD  then  sets  ITYPE  equal  to  IT2-20  and  executes  a  computed 
GO  TO  on  ITYPE.  As  a  result  of  this  computed  GO  TO,  control  transfers 
to  one  of  eight  sections  where  the  formatted  temporary  data  is  read. 

Each  of  these  sections  corresponds  to  one  of  the  eight  data  blocks  and 
each  consists  mainly  of  READ  statements  that  fill  in  that  data  block's 
variables.  When  the  reading  is  completed,  control  branches  to  statement 
number  410  where  a  return  occurs. 

9.16  DETCTN  Subroutine. 

This  subroutine  samples  the  detection  time  distribution  to 
obtain  the  detection  delay  time  for  this  replication  (i.e.,  time  from 
unmask  until  D.O.  initiates  call  for  fire.  It  includes  detection,  ac¬ 
quisition,  and  decision  time). 


I 


If  "random  occurrence"  is  being  played,  control  returns. 

If  "shooting  gallery”  is  being  played,  the  detection  delay  time  is 
compared  with  the  line  of  sight  duration  (test  4).  If  the  test  is 
passed,  a  return  occurs;  if  the  test  is  failed  the  abort  totaller  is 
called  (ABRTTL)  prior  to  the  return. 

9.17  DFAULT  Subroutine. 

This  routine  merely  sets  the  oefault  values  for  many  of  the 
case  descriptor  parameters,  data  block  record  names,  and  flags.  (It 
could  real ly  be  replaced  by  some  data  statements  to  fill  in  these  same 
variables  if  one  so  desires). 

9.18  DFCHK  Subroutine. 

This  subroutine  performs  test  14.  If  the  FO  (00)  has  been 
killed  on  a  previous  call  for  the  current  replication,  control  trans-' 
fers  to  120  where  the  round  abort  is  totalled  (call  to  ABRTTL)  followed 
by  a  return. 

Otherwise,  the  routine  calculates  the  current  designator-to- 
target  range.  Then  it  uses  that  range  value  to  interpolate  in  the  DFFOKL 
array  to  obtain  probability  that  direct  fire  kills  the  DO  and  probability 
that  direct  fire  obscures  but  does  not  kill  the  DO.  When  these  probabilities 
are  obtained,  test  14  is  performed  to  determine  whether  the  DO  is  unaffected, 
obscured  but  not  killed,  or  killed.  If  the  DO  is  unaffected,  the  routine 
returns;  if  the  DO  is  obscured  but  not  killed,  the  routine  calls  ABRTTL 
to  increment  the  round  abort  counter  and  then  returns;  and,  if  the  DO  is 
killed,  the  routine  increments  the  DO  killed  counter,  sets  the  DO  killed 
flag,  then  calls  ABRTTL  and  returns. 

9.19  DUST  Subroutine. 

This  subroutine  performs  test  6  and  calls  ABRTTL  if  the  test 
is  failed. 

9.20  ECHO  Subroutine. 

This  subroutine  takes  the  integer  argument  I UN IT.  I  UN I T  is 

the  logical  I/o  unit  to  which  ECHO  will  write.  ( I UN I T  =  8  currently) 

Subroutine  ECHO  does  nothing  more  than  write  out  the  current 
values  of  the  parameters,  flags,  arrays,  etc.  that  describe  the  conditions 
of  the  case,  (see  section  7.6)  This  printout  is  provided  primarily  as 
a  debugging  aid. 

9.21  FINDIT  Subroutine. 

This  subroutine  takes  a  real  array  B  of  character  strings 
dimensioned  N1  by  N2  and  returns  an  integer  valued  array  IT 
dimensioned  N3.  Normally  N1  -  8,  N2  -  10,  and  N3  =  10  so  we  have 


DIMENSION  B(8,  10),  IT  (10).  The  Kth  line  of  B  (i.e.,  B(J,K)  for  J  = 
1,2,3,. ...8  with  K  fixed)  consists  of  the  character  string  found  in  the 
Kth  field  of  the  input  card  just  read.  This  character  string  is  compressed 
by  eliminating  blanks  (the  exception  is  that  blanks  occurring  in  PEDATA 
record  names  preceded  by  $  are  preserved  when  moved  into  the  B  array) 
and  packing  the  results  10  characters  per  word  into  B. 

Subroutine  FINDIT  compares  the  first  line  of  the  B  array  (B(l,l) 
through  B(8,l))  with  the  keywords  in  the  CHAR  array  in  an  attempt  to 
find  a  match.  If  not  successful,  an  error  message  and  error  stop  occur; 
if  a  match  is  found,  then  I T ( 1 )  is  set  to  the  keyword  number  (contained 
in  CHAR  array  also). 

Next,  if  the  match  occurred  with  the  TEMPORARY,  OVERRIDE,  or 
RESET  keywords,  then  a  second  pass  through  the  keyword  list  (CHAR  array) 
is  made  to  find  a  match  with  the  second  line  of  the  B  array.  If  this 
search  is  successful,  IT ( 2 )  is  set  to  the  value  of  the  matched  keyword 
and  a  return  occurs.  If  unsuccessful,  an  error  message  and  stop  occurs. 

An  error  message  and  stop  also  occur  if  a  match  is  found  for  a  keyword 
that  is  not  allowed  with  TEMPORARY,  OVERRIDE,  or  RESET. 

If  the  first  match  was  not  with  TEMPORARY,  OVERRIDE,  or  RESET, 
then  the  routines  checks  CHAR  (2,  IMATCH)  to  see  how  many  option  word 
character  strings  are  allowed  with  the  I T ( 1 ) th  keyword.  If  this  number 
is  zero,  that  is  the  flag  to  the  program  that  it  may  have  one  of  the 
keywords  that  takes  only  numerical  values  and  so  control  transfers  to 
statement  210.  At  statement  210,  B(l,2)  is  checked.  If  B ( 1 , 2 )  is  blank, 
a  return  occurs;  if  B(l,2)  is  numeric  data,  IT(2)  is  set  to  zero ;  if 
B(l,2)  is  neither  blank  nor  numeric  an  error  print  occurs.  Note  that 
the  blank  occurs  either  when  the  keyword  has  no  optionwords  allowed  (as 
with  FIRST  CASE,  END,  etc.)  or  when  the  keyword  is  omitted  (i.e.,  the 
default  valued  is  desired). 

If  CHAR(2,  IMATCH)  is  non-zero,  it  gives  the  number  of  dif¬ 
ferent  option  word  character  strings  allowed  with  the  current  card's 
keyword.  The  TAPE  11  recor-'  name  is  then  set  to  the  abbreviated  form  of 
the  keyword  and  the  record  of  option  word  character  strings  allowed  with 
the  keyword  is  read  into  the  CHARA  array.  The  program  then  proceeds  to 
match  B(2,l)  through  B(2,8)  with  allowable  option  word  choices  for  option 
word  1,  B(3,l)  through  B(3,8)  with  allowable  choices  for  option  word  2, 
etc.  If  a  match  is  not  found  for  any  line  of  B,  then  it  is  tested  to 
see  whether  it  is  numeric;  if  not,  an  error  message  and  stop  occur,  if 
it  is  numeric,  the  next  line  of  B  is  checked.  If  line  K  of  B  is  numeric, 
IT(K)  is  set  to  zero;  if  line  K  of  B  is  blank,  I T ( K )  is  left  at  one  (the 
value  indicating  default)  to  which  it  was  set  near  the  beginning  of 
FINDIT;  if  line  K  of  G  matches  one  of  the  character  strings  allowed 
for  option  word  K-l,  then  I T ( K )  is  set  equal  to  the  number  of  the  option 
word  choice. 


It  is  through  setting  the  IT  array  that  FINDIT  signals  sub¬ 
routine  INPUT  as  to  which  keyword  and  optionwords  were  found  on  the 
input  card.  Of  course,  in  the  case  of  numeric  data  or  OVERRIDE  record 
names,  the  values  in  the  B  array  will  have  further  use  even  after  IT  has 
been  determined. 

9.22  GETRNG  Subroutine. 

This  subroutine  samples  the  cumulative  distribution  of  ac¬ 
quisition  ranges  (actually  designator-to-target  ranges  at  time  of  unmask) 
to  obtain  the  initial  designator-to-target  range  for  the  current  replication. 
The  cumulative  distribution  of  1 ine-of-sight  segment  lengths  corresponding 
to  the  range  bracket  in  which  the  designator-to-target  range  lies  is 
then  sampled  to  obtain  the  length  of  the  segment  of  the  target’s  path 
that  is  visible  to  the  DO.  This  LOS  segment  length  is  then  added  to  the 
target  column's  length  and  the  sum  is  divided  by  the  target  velocity  to 
obtain  the  duration  of  line  of  sight  (i.e. ,  the  length  of  the  time  interval 
from  target  unmask  until  LOS  to  last  vehicle  in  column  is  lost).  Next  a 
return  is  executed. 

If  the  target  velocity  is  zero  (or  negative)  an  error  stop  with 
message  occurs. 

9.23  GETTIM  Subroutine. 

This  subroutine  serves  three  basic  functions:  (1)  perform 
test  8,  (2)  perform  test  9,  and  (3)  calculate  the  response  time  (time 

from  DO  call  for  fire  until  gun  is  ready  to  fire  Copperhead)  for  those 
missions  that  pass  tests  8  and  9. 

As  mentioned  in  Chapter  2,  there  are  three  different  ways  of 
playing  communication  and  processing  delay  times. 

(1)  If  parameterized  response  time  (PRSPTM)  is  non-zero, 
then  this  routine  sets  the  time  the  gun  is  ready  to  fire  (TIMNOW)  equal 
to  PRSPTM.  It  then  performs  test  8  and  9.  If  either  test  fails,  ABRTTL 
is  called  and  a  return  occurs;  otherwise,  ABRTTL  is  not  called  and  the 
routine  executes  a  return  with  TIMNOW  =  PRSPTM. 

(2)  If  parameterized  response  time  is  zero,  then  the  routine 
is  to  sample  to  obtain  response  time.  If  the  variable  FTSILL  is  TRUE, 
the  routine  samples  the  single  response  time  distribution  (FSRT  array) 
to  obtain  the  response  time  which  is  then  added  to  the  detection  time  to 
obtain  the  time  at  which  the  gun  is  ready  to  fire.  It  then  performs 
tests  8  and  9.  If  either  test  fails,  ABRTTL  is  called  and  a  return 
occurs;  otherwise,  ABRTTL  is  not  called  and  the  routine  executes  a  return 
with  TIMNOW  set  at  the  value  to  be  used  for  this  replication. 


(3)  Finally,  if  parameterized  response  time  is  zero  and  the 
variable  FTSILL  is  FALSE,  then  the  routine  uses  the  sum  of  the  separate 
response  time  components  as  the  response  time.  If  digital  communication 
is  modeled,  then  the  time  to  enter  digital  data  into  DMD  is  sampled  and 
added  to  current  time  (TIMNOW  which  was  previously  set  to  DETTIM). 

Then  an  unnumbered  test  is  made  to  determine  whether  digital 
commo  is  successful.  If  it  is,  a  transmission  time  is  added  to  TIMNOW 
and  control  transfers  to  statement  160  (see  below).  If  digital  commo 
fails,  then  a  test  is  performed  to  determine  whether  voice  commo  is 
successful.  If  voice  is  successful,  then  a  time  to  switch  from  digital 
to  voice  and  the  voice  commo  transmission  time  are  added  to  TIMNOW  before 
control  transfers  to  statement  160.  If  voice  is  also  unsuccessful,  then 
test  8  is  considered  to  have  been  failed,  ABRTTL  is  called,  and  a  return 
executed. 

If  digital  commo  is  not  selected,  then  voice  commo  only  is 
played.  In  this  case,  the  test  for  successful  voice  commo  is  made  (test 
8)  and  if  failed,  an  abort  (call  to  ABRTTL)  occurs  followed  by  a  return. 

If  the  test  is  passed,  a  voice  commo  time  is  added  to  TIMNOW  and  control 
reaches  statement  160. 

At  statement  160,  the  battery  computer  system  processing  and 
battery  response  time  are  added  to  TIMNOW.  Test  9  is  then  performed.  If 
it  fails,  ABRTTL  is  cal  led  and  a  return  executed;  if  it  is  passed,  then 
TIMNOW  is  returned  to  be  used  for  the  current  replication. 

9.24  GETVIS  Subroutine. 

This  subroutine  samples  the  weather  data  used  in  the  current 
case  to  obtain  the  cloud  ceiling  altitude  and  the  visibility  range  limit. 

The  routine  first  randomly  determines  whether  there  is  a 
cloud  ceiling.  Next  it  randomly  determines  whether  there  is  a  cloud 
free  1 ine-of-sight  for  the  COPPERHEAD  trajectory. 

If  there  is  a  cloud-free  1 ine-of-sight,  then  the  cloud  ceiling 
altitude  is  set  to  its  highest  value  and  a  visibility  limit  is  determined 
by  random  sampling  using  the  PRGCFL  array.  Control  then  branches  to 
statement  160  (see  below). 

If  there  is  no  cloud-free  li ne-of-sight,  then  the  cloud  ceiling 
altitude  and  visibility  limit  are  both  determined  by  a  random  sampling 
from  t he  W  array. 

Note  that  the  items  of  importance  that  are  defined  by  this 
routine  are  the  subscript  of  the  cloud  ceiling  altitude  (ICC),  the  subscript 
of  the  visibility  range  limit  (IVL),  and  the  visibility  range  limit  itself 
(VISLIM).  Also,  note  that  ICC  is  initially  a  function  of  increasing 
altitude  (that  is,  higher  altitudes  correspond  to  larger  values  of  ICC); 
however,  because  the  ordering  convention  for  cloud  ceilings  was  reversed 
between  the  weather  data  and  the  PE  data,  ICC  is  redefined  after  statement 


160  by  setting  the  new  value  of  ICC  equal  to  seven  minus  the  old  ICC 
value  (so  that  higher  altitudes  correspond  to  lower  values  of  ICC). 

9.25  HEADER  Subroutine. 

This  subroutine  produces  the  heading  page  for  each  case. 

The  heading  page  is  produced  by  encoding  the  lines  for  the 
first  column  of  boxes  into  the  AOUT  array;  those  for  the  second  column 
into  the  GOUT  array;  and  those  for  the  third  column  into  the  COUT  array. 

Next  the  routine  generates  some  comments  regarding  time  in¬ 
consistencies,  record  name  overrides,  and  data  read  by  the  TEMPORARY 
option  as  applicable. 

Finally,  following  the  lines  giving  case  number  and  number 
of  replications  (which  are  written  before  HEADER  does  any  encoding) 

HEADER  writes  the  AOUT,  P>0UT,  and  COUT  arrays  to  produce  the  nine  boxes 
of  case  description  information  that  occur  on  the  case  header  page. 

Then  if  any  "$$"  comments  are  to  be  printed  for  this  case,  the  CMENT 
array  is  written  (this  includes  both  user  comments  and  program  generated 
comments) . 

9.26  HITCHK  Subroutine. 

This  subroutine  performs  test  18. 

First,  it  interpolates  with  respect  to  designator-to-target 
range  (RNGflOW)  in  the  proper  row  of  the  TTF  array  as  determined  by  desig¬ 
nator  type  and  target  posture  (exposure)  to  obtain  the  probability  of 
hit.  This  probability  of  hit  is  really  the  probability  of  hit  given 
that  the  round  engages  (that  is/that  the  seeker  locks  onto  the  laser 
spot  on  the  target  and  does  so  within  the  maneuver  footprint  of  the 
COPPERHEAD  round). 

Next  the  routine  compares  a  random  number  (between  0  and  1) 
to  the  probability  of  hit  to  determine  whether  the  current  round  hits. 

If  the  round  hits,  a  return  occurs;  if  not,  ABRTTL  is  called  to  record 
the  failure  (miss)  and  a  return  occurs. 

9.27  INITLZ  Subroutine. 

The  subroutine  initializes  certain  case  independent  values. 

After  setting  IRAY  and  calling  SYSTEMC  to  set  the  non-stand¬ 
ard  error  recovery  process,  the  routine  proceeds  to  set  the  values  of 
CHAR  (2,1)  for  I  =  1,2,...NREC  from  the  values  in  the  record  named  OPTNNUMS 
on  Tape  11.  (This  record  is  automatically  updated  by  the  PREPMS  program 
each  time  new  optionword  character  strings  are  added  for  a  keyword). 
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The  program  next  calls  DFAULT  to  set  the  default  values  for 
the  various  case  descriptors,  record  names,  etc.  Then  USET  is  called 
to  set  the  values  to  be  used  as  the  base  to  which  the  first  case  input 
card  values  are  to  be  applied.  Finally,  MSADLM  is  set  and  a  return  is 
executed. 

9.28  INPUT  Subroutine. 

This  subroutine  reads  the  input  lines  for  a  given  case  and 
sets  the  variables  in  the  program  to  the  values  required  to  run  the 
case. 


This  routine  is  the  longest  and  one  of  the  most  complex  in 
the  COPE  model.  It  is  most  easily  followed  by  means  of  a  flowchart 
(see  Chapter  11);  however,  an  attempt  to  sketch  its  main  sections  is 
given  here. 

(1)  First,  the  routine  checks  to  determine  whether  there  is 
another  case  to  read.  If  not,  it  stops.  If  there  is  more  to  read,  the 
routine  first  sets  IRAY  and  calls  SYSTEMC  to  establish  non-standard 
error  recovery.  Then  it  clears  various  arrays  and  counters  and  increments 
the  case  number. 

(2)  Next  it  reads  input  cards  until  it  encounters  an  END, 

FNDF,  or  end-of-file.  For  each  card  that  it  reads,  it  first  checks 
whether  that  card  is  a  comment  card;  if  it  is,  subroutine  COMMNT  is 
called  and  the  next  card  is  read.  If  the  card  is  not  a  comment,  the 
routine  calls  SEPREC  which  separates  the  fields  on  the  input  card  and 
moves  each  of  them  into  a  line  of  the  B  array.  Then  subroutine  FINDIT 
is  called  to  match  each  line  in  the  B  array  against  the  keywords  and 
option  words  allowed  in  that  field.  This  matching  determines  the 
values  of  the  IT  array. 

The  program  next  checks  to  see  whether  the  current  card  supersedes 
some  of  the  previous  cards  for  the  current  case.  If  it  does,  a  comment 
is  generated;  in  either  case,  the  routine  next  branches  to  one  of  five 
statements  depending  on  whether  the  card  is  a  FIRST  CASE,  NEXT  CASE, 

END,  ENDF,  or  any  other  card,  respectively.  If  the  card  is  an  END  or 
ENDF,  control  transfers  to  statement  490  (see  below).  If  the  card  is  a 
NEXT  CASE,  RD  (or  equivalent),  USET  is  called  to  establish  the  default 
values  as  the  base  to  which  changes  caused  by  the  input  cards  are  to  be 
applied;  if  the  card  is  NEXT  CASE,  DR,  then  USET  is  not  called  and  the 
changes  caused  by  the  input  cards  are  applied  to  the  conditions  in  effect 
for  the  previous  case.  Either  type  of  NEXT  CASE  (or  FIRST  CASE)  causes 
control  to  then  read  the  next  card.  If  the  card  is  not  an  END,  ENDF, 
NEXTCASE,  or  FIRST  CASE,  then  control  reaches  statement  200. 
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At  statement  200,  a  many  branched  computed  GO  TO  is  executed; 
the  branch  followed  depends  on  the  keyword  number  (IT1  or  1 1 ( 1 ) ) .  The 
actions  taken  for  each  case  of  the  computed  GO  TO  are  varied  but  the 
main  activities  are  to  fill  the  UVALUE  array  with  either  numerical  values, 
record  names,  or  flag  values.  If  the  keyword  was  TEMPORARY ,  CREAL)  is 
called;  if  OVERRIDE ,  the  record  name  is  set;  and  if  RESET,  the  default 
for  that  keyword  is  reactivated.  Each  case  of  t he  computed  GO  TO  ends 
with  a  GO  TO  returning  control  to  the  line  that  reads  the  next  input 
card. 

(3)  At  line  490  the  routine  starts  filling  in  the  values  of 
the  various  parameters  that  describe  the  current  case  (flags,  arrays, 
single  variables,  etc.).  These  are  generally  filled  in  by  calls  to 
READMS  to  read  records  to  fill  in  data  blocks  (record  names  as  established 
when  filling  in  UVALUE  array),  by  equating  variables  to  UVALUE  numerical 
values,  by  looking  up  values  in  pre-defined  arrays  according  to  a  subscript 
value  in  UVALUE  array,  by  calling  a  special  subroutine  (in  the  case  of 
PEDATA)  to  generate  a  record  name  and  then  reading  that  record  from  TAPE  11 
into  the  data  block,  or  by  calling  special  routines  (such  as  PSMOKE) 

that  use  inputs  to  calculate  a  parameter  value.  In  any  event,  by  the 
end  of  INPUT  all  variables  required  to  run  the  case  have  been  set  and 
the  replications  can  begin. 

(4)  INPUT  finishes  by  calling  HEADER  and  ECHO  and  then  returning. 

9.29  LOSCHK  Subroutine. 

This  subroutine  is  used  to  determine  whether  the  DO  still  has 
(macro-terrain)  LOS  to  the  target  when  the  round  arrives  (test  12). 

It  performs  the  test  in  two  different  ways  depending  on  the 
LOS  model  used. 

For  "shooting  gallery",  it  merely  compares  the  time  the  round 
arrives  with  the  duration  of  the  1 ine-of-sight.  If  the  round  arrives 
before  the  1 i ne-of-sight  ends,  a  return  is  executed;  if  the  LOS  ends 
before  the  round  arrives,  ABRTTL  is  called  prior  to  the  return. 

For  the  "random  occurrence"  LOS  model,  the  probability  P  of 
LOS  to  a  single  vehicle  in  the  current  designator-to-target  range  bracket 
is  found.  The  probability  that  at  least  one  vehicle  is  in  view  is  then 
taken  to  be  equal  to  1-(1-P)**XNV  where  XNV  is  the  number  of  target 
vehicles  currently  unkilled.  Once  this  probability  is  obtained,  it  is 
compared  to  a  random  number  and  the  result  settles  test  12.  If  test  12 
is  passed,  a  return  occurs;  if  it  is  false,  ABRTTL  is  cal  led, then  a 
return  occurs. 


9.30  MINTRN  Subroutine. 


This  subroutine  performs  test  16  and  sets  target  posture 
(exposure)  with  respect  to  mini-terrain. 

First  the  current  designator-to-target  range  is  computed. 

Then  this  range  is  used  to  interpolate  in  each  of  the  three  rows  of 
the  PSTTBL  array.  As  a  result  of  this  interpolation  the  PSTVAL  array 
is  filled  with  the  probabi 1 ities  of  completely  obscured  target  posture, 
fully  exposed  target  posture,  and  hull  defilade  (turret  exposed)  target 
posture  respectively. 

A  random  number  is  then  drawn  and  compared  to  these  proba¬ 
bilities  to  determine  which  of  the  three  target  postures  occurs.  If  the 
target  posture  is  "completely  obscured",  then  test  16  is  failed,  ABRTTL 
is  called,  and  a  return  occurs;  otherwise,  1TGTPS  is  set  to  indicate  the 
target  posture  (1  for  fully  exposed;  2  for  hull  defilade)  to  be  used  in 
hit  and  kill  probability  tests  and  a  return  occurs. 

9.31  NOREC  Subroutine. 

This  routine  is  called  indirectly  through  the  CDC  non-stand¬ 
ard  error  recovery  facility  (SYSTEMC  routine  explained  in  CDC  Fortran 
4  Extended)  It  is  called  whenever  READMS  attempts  to  read  a  record 
from  TAPE  11  using  a  record  name  that  does  not  correspond  to  any  of  the 
records  on  TAPE  11. 

The  routine  writes  a  message  giving  the  record  name  that 
could  not  be  found,  executes  a  subroutine  call  trace  and  then  executes  a 
stop  with  message. 

9.32  OUTPUT  Subroutine. 

This  subroutine  writes  the  results  page  for  each  case. 

The  routine  begins  by  clearing  several  arrays. 

Next,  it  calculates  the  percentage  of  total  missions  that  have 
a  failure  (abort)  at  each  test  (for  "round"  aborts,  this  percentage  is 
calculated  for  each  round).  This  is  the  ABRPCT  array. 

Then  it  calculates  what  percentage  of  the  missions  that  reached 
a  given  test  passed  it.  Again  this  is  calculated  for  each  round  for  the 
"round"  aborts.  This  is  the  PASPCT  array. 

Next  the  program  sets  the  number  of  occasions,  attempted 
engagements,  and  shots. 

Then  it  compares  the  number  of  kills  as  calculated  by  two 
different  counters  and,  if  there  is  a  disagreement  in  value  between 
them,  it  prints  a  message  (see  Section  7.3.1). 


Next,  it  calculates  the  probability  of  kill  given  an  occasion, 
the  probability  of  kill  given  an  attempted  engagement,  and  the  probability 
of  kill  given  a  shot.  Thes'e  are  calculated  separately  for  each  round  of 
the  mission. 

Then  it  calculates  the  probability  of  a  shot  given  an  occasion, 
probability  of  a  shot  given  an  attempted  engagement,  and  probability  of 
attempted  engagement  given  a  shot.  It  also  calculates  the  probability 
of  having  1 ine-of-sight  on  each  round. 

Next  it  compares  the  number  of  missions  (or  rounds,  as  appropriate) 
tested  for  each  abort  condition  as  computed  in  two  different  ways.  If 
the  results  differ  an  error  message  is  generated  (see  section  7.3.2). 

Then  the  program  calculates  the  FO  (DO)  survivability  measures; 
that  is,  probability  DO  is  killed  and  probability  DO  is  not  killed  given 
that  the  mission  reached  that  test. 

Now  that  all  of  the  values  to  be  printed  on  the  results  page 
have  been  calculated  the  routine  proceeds  to  print  the  results  in  the 
order  they  appear  on  the  case  results  page  (see  Chapter  6). 

Note  that  prior  to  printing  percentages,  function  FPRCNT  is 
applied  to  format  the  percentages  for  output.  Also  note  that  any 
percentage  valued  variables  with  the  value  -1.0  are  printed  as  "UNDEF" 
indicating  undefined  value  (this  occurs  when  the  percentage  could  not 
be  calculated  due  to  a  zero  denominator.  It  is  for  this  reason  that 
all  percentage  valued  variables  in  OUTPUT  are  initialized  at  -1.0  and 
then  only  assigned  values  if  the  ratio  used  in  computing  the  percent¬ 
age  has  non-zero  denominator). 

9.33  PECHK  Subroutine. 

This  subroutine  performs  test  17  (i.e. ,  does  COPPERHEAD  round 
engage  the  target?) 

First  it  calculates  the  delay  time  (DELTAT)  for  the  current 
round.  By  delay  time  is  meant  the  time  the  round  arrives  minus  the 
expected  arrival  time  (which  is  based  on  nominal  response  time).  Next 
the  value  of  IMUTS  (the  "MUTS"  factor  --  see  Section  16.1)  is  determined 
and  the  range  value  indices  to  be  used  for  interpolation  are  set. 

If  IMUTS  is  2,  it  means  that  not  all  vehicles  in  the  target 
column  have  passed  the  point  of  closest  approach  to  the  centroid  of  the 
COPPERHEAD  footprint.  That  is,  delay  has  no  effect  and  so  PE  is  computed 
by  interpolating  with  respect  to  designator-target  range  alone  in  the 
PETBL  array  (using  delay  time  equal  to  zero  ( I DELTT =1 )  and  holding  cloud 
ceiling  and  visibility  limit  constant  at  their  previously  sampled  values 
(obtained  in  GETVIS)). 
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If  IMUT S  is  1,  it  means  that  all  vehicles  in  the  target  column 
have  passed  the  point  of  closest  approach  to  the  centroid  of  the  COPPERHEAD 
footprint.  That  is,  delay  time  has  an  effect  and  so  PE  is  computed  by 
interpolating  with  respect  to  both  designator-target  range  and  delay 
time  while  holding  cloud  ceiling  and  visibility  limit  constant. 

In  either  case,  once  PE  (probability  that  seeker  engages  target 
and  target  is  within  Copperhead  maneuver  footprint)  is  computed,  it  is 
compared  to  a  random  number  sampled  from  a  uniform  distribution  (from  0 
to  1).  If  the  random  number  is  less  than  PE,  a  return  occurs;  otherwise, 
ABRTTL  is  called  before  the  return  occurs. 

9.34  RENAME  Subroutine  and  PEIDNT  Entry. 

This  subroutine  takes  ten  arguments.  When  the  call  is  to 
PE NAME  the  first  nine  are  "input"  and  the  last  one  is  "result";  whereas 
a  call  to  PEIDNT  uses  the  current  value  of  the  tenth  argument  as  "input" 
and  returns  the  values  for  the  other  nine. 

This  subroutine  is  used  to  create  PE  data  record  names.  The 
values  of  the  nine  parameters  (see  section  5.4)  are  taken  as  arguments 
(in  the  same  order  they  are  described  in  section  5.4).  They  are  loaded 
into  the  AVALUE  array  and  are  searched  for  in  the  X VALUE  array.  When 
i, latches  are  found,  the  correspondi ng  XVALUE  entries  (for  XVALUE  ( I ,  J , 2 ) ) 
are  used  to  construct  the  record  name  which  is  returned  as  IDCODE. 

When  >EIDNT  is  called,  the  record  name  is  decomposed  into  the 
separate  XVALUE  (I , J , 2 )  values  (and  TR  value)  used  to  create  it.  The 
correspondi ng  XVALUE  (I,J,1)  values  are  found  and  equated  to  the  nine 
parameters  (note  slightly  different  hand 1 i ng  of  TR,  nominal  response 
time).  These  values  are  then  returned. 

Note  that  while  every  choice  of  the  nine  parameters  can  give 
at  most  one  record  name,  there  may  be  more  than  one  choice  of  param¬ 
eters  that  can  give  that  record  name.  For  example,  if  all  parameters 
are  held  constant  except  target  velocity  (VEL),  then  VEL  =  2  m/s  and 
VEL  =  3  m/s  will  give  the  same  record  name  (using  the  current  XVALUE 
array).  Hence,  when  that  record  name  is  decoded  by  PEIDNT  to  obtain 
the  parameters  to  which  it  corresponds,  it  will  have  no  way  of  choosing 
between  2  m/s  and  3  m/s  for  VEL;  instead  it  will  merely  take  the  first 
one  that  matches  (2  m/s  in  this  case). 

9.35  PKCliK  Subroutine. 

This  subroutine  performs  test  19  (i.e.  ,  did  the  COPPERHEAD 
ki 1 1  the  target?) 

The  routine  looks  up  the  PK  (probability  of  kill  given  a 
hit)  in  an  array  as  a  function  of  target  type  and  target  posture  (ex¬ 
posure).  This  value  is  then  compared  to  a  random  number  sampled  from 
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a  uniform  distribution  (from  0  to  1).  If  the  random  number  is  less 
than  PK,  then  a  kill  occurs,  the  number  of  vehicles  killed  on  the 
KRFth  round  for  this  case  (RNDREC)  is  incremented,  the  number  of  ve¬ 
hicles  killed  (NVEHKL)  on  this  replication  is  incremented  and  a 
return  occurs.  If  not,  ABRTTL  is  called  and  then  the  return  occurs. 

9.36  PPLOT  Subroutine. 

This  subroutine  is  currently  just  a  "stub"  that  producess  a 
"$$"  program  generated  comment  saying  that  no  printer  plot  was  produced 
for  the  current  case. 


If  implemented,  this  routine  would  produce  printer  plots 
(bar  graphs)  giving  a  graphical  presentation  of  case  results. 

9.37  PSMOKE  Subroutine. 

This  routine  calculates  the  probability  that  smoke  aborts 
the  potential  COPPERHEAD  mission.  This  probability  is  a  function  of 
the  number  of  each  of  two  types  of  smoke  rounds  fired  (NSMK2  and  NSMK5) 
and  the  distribution  of  Pasquill  atmospheric  stability  categories, 
distribution  of  wind  speed  velocities,  and  distribution  of  relative 
humidity  levels  corresponding  to  the  current  case's  weather  (i.e. ,  month 
and  time  of  day). 

The  entire  routine  reduces  to  evaluating  PSMKKL  (probability 
smoke  kills  mission)  according  to  the  formula: 


PSMKLL  = 


3  3  2 

FrSnt  Z  Z  Z 

1=1  J=1  K=1 


mim  {  NSMK2  ,  NSMK5  rcnwT\ 

N  y SMK2(I, J , K)  SMK5(I,J,-K),FR0NT  ) 


WNDSPD(I,J)  *  HUM  ID (K)  *  [pASQL (2*1 -1 )  +  PASQL(2* 


■>]} 


where  all  of  the  variables  are  as  defined  in  the  Glossary  of  Variables 
(Chapter  12). 


Note  that  because  certain  combinations  of  windspeed  and 
Pasquill  category  never  occur,  the  SMK2(I,J,K)  and  SMK5(I,J,K)  values' 
corresponding  to  them  have  been  left  blank  (i.e.,  equated  to  zero).  To 
avoid  the  division  by  zero  that  would  otherwise  result,  the  range  of  J 
in  the  summation  is  sometimes  limited  in  the  routine  to  avoid  certain 
SMK2  and  SMK5  values  which  should  have  no  weight  in  the  sum  anyway. 


9.38  REINTZ  Subroutine. 


This  subroutine  resets  certain  counter  arrays  to  zero.  It 
also  resets  the  random  number  seeds  for  each  case  and  on  the  first 
case  it  writes  the  seeds  on  Tape  8. 
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Note  that  the  seeds  are  set  according  to  the  formula: 


IR ( I )  =  2*(M0D (8**1 4  29)  *2**25/29)  +  1 


for  I  =  1,2,...,  28. 

This  assures  that  each  IR  is  odd  and  that  the  IR's  are 
approximately  uniformly  spaced  between  0  and  2^6. 

9.39  RNDREL  Subroutine. 

This  subroutine  performs  the  test  of  round  reliability 

(test  15). 

9.40  RNGCHK  Subroutine. 

This  subroutine  performs  test  3. 

It  compares  designator-to-target  range  at  unmask  to  the  maximum 
designator  range.  If  the  maximum  designator  range  is  less  than  the 
designator-to-target  range,  ABRTTL  is  called  and  a  return  occurs;  otherwise, 
the  test  is  passed  and  a  return  occurs. 

9.41  SEPREC  Subroutine. 

This  subroutine  takes  a  real  array  A  of  dimension  N1  and  breaks 
it  up  into  fields  ( i - e. ,  separates  records)  and  compresses  them  one  per 
line  into  the  B  array  which  is  of  dimension  N2  by  N3. 

The  routine  first  clears  several  arrays  to  be  used  in  separating 
the  fields  on  A.  Then  it  calls  IDCHAR  once  for  each  element  of  A  to 
determine  what  kind  of  character  it  is.  A  is  assumed  to  be  an  array 
(usually  DIMENSION  A(80))  of  characters  filled  by  reading  one  input  card 
under  80A1  format. 

If  the  routine  encounters  sequence  numbers  in  columns  73-78 
of  the  first  card  (i.e.,  elements  73-78  of  array  A)  and  blanks  in  63-72 
and  79-80,  then  it  issues  a  "$$$"  comment  (see  section  7.1)  and  removes 
the  sequence  numbers  on  the  first  card  and  all  subsequent  cards  (A  arrays) 
of  the  current  run.  If  it  encounters  something  other  than  the  blanks 
and  sequence  numbers  as  described  above  in  columns  63-80  of  the  first 
card,  then  it  leaves  columns  73-78  unchanged  on  all  cards  of  the  current 
run. 


Next  the  program  separates  the  fields  on  the  card  (i.e.,  in 
A)  and  compresses  them  into  B.  It  does  this  by  copying  one  character 
at  a  time  from  A  to  PB  omitting  blanks  (except  when  part  of  a  ten 
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character  string  preceded  by  a  "$"  sign)  and  starting  a  new  line  of  PB 
every  time  a  separator  (comma,  left  or  right  parenthesis,  question 
mark,  or  slash)  is  encountered.  It  then  encodes  each  line  of  PB  into 
a  line  of  B  so  that  each  element  of  B  contains  up  to  ten  characters. 

This  means  that  B ( I , J )  for  I  =  1,2,...  ,8  contains  the 
characters  of  the  Jth  field  of  the  input  card  compressed  by  removing 
blanks  (with  the  exception  noted)  and  packed  ten  characters  per  word 
(until  the  characters  run  out). 

A  return  now  occurs  with  the  B  array  filled  with  the  char¬ 
acter  strings  to  be  compared  to  the  keywords  and  option  words  allowed. 

Note  that  an  input  card  cannot  have  more  than  ten  fields  nor 
fewer  than  one.  A  field  on  an  input  card  (or  in  A)  is  defined  as  a 
string  of  characters  lying  between  two  successive  separators  where  for 
this  definition  we  include  the  beginning  of  the  card  and  the  end  of  the 
card  as  separators  and  do  not  count  characters  that  would  otherwise  be 
separators  if  they  lie  in  a  ten  character  string  following  a  dollar 
sign.  (The  normal  separators  are  mentioned  above  in  this  section). 

9.42  SMOKE  Subroutine. 

It  compares  the  value  of  PSMKKL  calculated  in  PSMOKE  with  a 
random  number  sampled  from  a  uniform  distribution  to  determine  whether 
smoke  was  sufficient  to  abort  the  potential  Copperhead  mission.  As 
usual,  if  an  abort  occurs,  ABRTTL  is  called  prior  to  returning;  other¬ 
wise,  an  immediate  return  occurs. 

9.43  SMPLCD  Subroutine. 

This  subroutine  randomly  samples  from  a  cummulative  distri¬ 
bution.  As  arguments,  it  takes  an  array  A,  its  dimensions  ND1,  ND2,  the 
row  number  NRS  containing  the  values  to  be  sampled,  the  number  of  entries 
NDR  used  in  the  row  (NDR  <  N01),  and  the  random  number  seed  IRNDM.  It 
returns  the  value  sampled  XSMPL  and  the  class  ICLASS  in  which  it  falls. 

This  routine  requires  an  array  A  with  A ( I , 1 )  for  I  =  1,2,., 

NDR  <  ND1  consisting  of  probabilities  A(l,l)  =  0.0  _<  A(2,l)  _<  ...  A(NDR,1) 
=  l.U.  The  routine  samples  a  random  number  RN  from  a  uniform  distribution 
(from  0  to  1)  and  then  brackets  this  number  with  two  entries  from  A(I,1) 
such  that  A( I ,1 )  <  RN  <  A(I+1,1). 

The  correspond!' ng  entries  A(I,NRS)  and  A(I+1,NRS)  from  the 
NRSth  row  of  A  are  obtained.  The  value  sampled  XSMPL  is  then  defined 
by  straight  line  interpolation,  (i.e.,  XSMPL  is  defined  so  that  the 
point  (RN,  XSMPL)  lies  on  the  line  segment  joining  (A(I,1),  A(I,NRS)) 
to  (A(I+1,1),  A( 1+1 ,NRS) ) ) . 

Put  in  terms  of  a  formula,  that  means: 

XSMPL  «  A( I , NRS )  +  (RN-A( I ,1 ) )*(A( I +1 ,NRS)-A( I ,NRS) )/ (A(I+1 , 1 )  -A( 1,1)). 
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ICLASS  is  then  defined  to  be  equal  to  I  and  a  return  occurs. 
Mote  that  A  defines  a  cummulative  distribution.  That  is,  when 

sampl i ng. 


Pr (XSMPL  <  A( I, NRS) )  =  A(I,1)  for  I  =  1,2,...,NDR. 

Hence,  the  user  must  take  care  to  use  only  cummulative  distributions 
for  the  input  data  that  will  eventually  be  sampled. 

9.44  TIMCHK  Subroutine. 

This  subroutine  performs  test  11  (i.e.  ,  does  the  DO  still 
have  1 ine-of-sight  to  the  target  v/hen  the  battery  is  ready  to  fire?) 

It  is  called  only  for  the  "shooting  gallery"  LOS  model. 

9.45  TITLE  Subroutine. 

This  routine  merely  writes  the  Title  page  of  the  output  (see 
Chapter  6).  It  also  sets  the  date  and  time  that  the  current  run  began. 

9.46  USET  Subroutine. 

This  subroutine  is  called  when  the  next  case  to  be  run  is  to 
use  the  baseline  (default)  values  of  the  case  parameters  as  the  base 
to  which  its  own  input  cards  are  to  be  applied. 

The  routine  sets  the  UVALUE  common  block  and  a  few  other 
variables  to  their  default  values.  Whatever  inputs  the  next  case  then 
contains  are  applied  to  changing  these  variables  from  their  defaults 
rather  than  from  the  previous  cases  values. 

9.47  VISCHK  Subroutine. 

This  subroutine  performs  test  2. 

It  compares  designator-to-target  range  at  unmask  to  the  visibility 
range  limit.  If  the  visibility  range  limit  is  less  than  the  designator- 
to-target  range,  ABRTTL  is  called  and  a  return  occurs;  otherwise,  the 
test  is  passed  and  a  return  occurs. 

9.48  WARNDO  Subroutine. 

This  subroutine  performs  test  13. 

If  the  current  round  is  the  first  of  this  COPPERHEAD  mis¬ 
sion,  then  a  random  number  is  sampled  from  a  uniform  distribution  and 
compared  to  the  probability  that  DO  is  warned  to  lase  to  determine  whether 
the  DO  received  the  message  to  begin  lasing.  If  he  did  receive  the 
message,  the  test  is  passed  and  a  return  occurs;  if  not,  ABRTTL  is  called 
prior  to  returning. 

If  the  current  round  is  not  the  first  round  of  this  COPPERHEAD 
fire  mission,  then  DO  is  assumed  to  have  been  warned  either  by  communication 
or  by  sighting  the  impact  of  the  first  round  and,  in  either  case,  turns 
on  his  laser  so  test  13  is  passed  and  a  return  occurs. 
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CHAPTER  10 


10.  MEMORY  ORGANIZATION:  COMMON  BLOCKS  AND  EQUIVALENCE  CLASSES 

10.1  Common  Blocks. 

This  chapter  describes  the  common  blocks  and  equivalence  classes 
in  COPE.  This  organization  of  the  values  stored  in  memory  is  a  matter  of 
some  importance  to  anyone  attempting  to  modify  the  program. 

Tables  10-1  and  10-2  give,  respectively,  a  list  of  the  common 
blocks  in  each  subprogram  of  COPE  and  a  list  of  the  subroutines  in  which 
each  common  block  occurs. 

10.2  Equivalence  Classes. 

Table  10-3  gives  the  equivalence  classes.  There  are  twelve 
equivalence  classes  used  in  COPE  (some  are  used  in  more  than  one  subroutine). 
The  equivalence  classes  are  described  below  in  alphabetical  order  of  the 
names  of  their  first  items.  Eight  of  the  twelve  equivalence  classes  are 
the  eight  data  blocks  referred  in  Section  4.5.1.: 

ACQDAT  is  the  Acquisition  Range  data  block, 

AINVDA  is  the  Invariant  data  block, 

DFSDAT  is  the  Direct  Fire  Suppression  data  block, 

PEDATA  is  the  Probability  of  Engagement  data  block, 

STDAT  is  the  Target  Posture  Distribution  data  block, 

RODATA  is  the  Random  Occurrence  data  block, 

RSPDAT  is  the  Response  Time  data  block,  and 
WDATA  is  the  Weather  data  block. 

These  data  block  equivalence  classes  (along  with  a  MAX  equivalence 
class  which  has  nothing  to  do  with  COPE's  use  of  PREPMS)  are  also  present 
in  the  PREPMS  program. 

Each  equivalence  class  is  formed  by  an  equivalence  statement 
establishing  that  one  array  or  non-subscripted  variable  occupies  the  same 
memory  locations  as  a  set  of  one  or  more  other  arrays  or  non-subscripted 
variables.  In  each  case  the  one  array  or  non-subscripted  variable  (after 
which  the  equivalence  class  is  named  in  Table  10-3)  occupies  all  of  the 
computer  memory  used  by  that  equivalence  class  and  so  is  dimensioned  with  a 
value  equal  to  the  entire  length  of  the  equivalence  class  (if  the  length  is 
1,  then  the  equivalence  class  occupies  but  one  word  of  computer  memory  and 
the  class  is  named  after  a  non-subscripted  variable). 

In  Table  10-3,  the  information  about  each  equivalence  class  is 
separated  by  dashed  lines  and  is  read  as  follows: 

The  first  entry  on  the  left  gives  the  name  of  the  equivalence 

class. 


10-1 


The  next  entry  (length)  gives  the  length  of  the  equivalence  class 
in  terms  of  the  words  of  computer  memory  occupied  by  the  members  of  the 
equivalence  class.  This  length  is  also  the  dimension  of  the  array  (or  non- 
subscripted  variable  if  length  is  one)  in  the  first  entry. 

The  entries  under  "MEMBERS"  give  bias,  name,  and  length  of  each 
member.  That  is,  for  each  member  (variable)  of  the  equivalence  class  (other 
than  the  member  in  the  first  entry  above)  there  are  three  items  given: 
first  the  bias  or  number  of  words  preceding  the  variable  in  that  equivalence 
class  in  computer  memory  space,  second  the  variable  (or  array)  name,  and 
third  the  length  of  the  array  (or  non-subscripted  variable)  in  terms  of 
computer  words  (one  for  non-subscripted  variables). 

Note  that  for  each  equivalence  class,  the  memory  space  occupied 
is  part  (or  all)  of  some  common  block.  This  correspondence  is  as  follows: 

ACQOAT  is  in  the  RN6L0S  common  block, 

AINVDA  is  in  the  HIT  common  block, 

D  is  in  the  DVALUE  common  block, 

DFSDAT  is  in  the  DODF  common  block, 

ICODE  is  in  the  ICODE  common  block, 

PEDATA  is  in  the  HIT  common  block, 

PSTDAT  is  in  the  HIT  common  block, 

RECODE  is  in  the  RECNAM  common  block, 

RODATA  is  in  the  RANDOC  common  block, 

RSPDAT  is  in  the  RSPTIM  common  block, 

U  is  in  the  UVALUE  common  block,  and 
WDATA  is  in  the  WEATHR  common  block. 

Also,  note  that  the  variables  in  an  equivalence  class  may  be  used 
(under  their  names  in  the  COMMON  statements)  in  subprograms  other  than 
those  in  which  the  equivalence  class  is  defined. 


TABLE  10-1  COMMON  BLOCKS  iN  EACH  SUBPROGRAM  OF  THE  COPE  PROGRAM 


SUBPROGRAM 

COMMON 

BLOCKS 

AERTTL 

ABORT 

FI  AG 

RPl CTN 

ADDTBR 

TIME 

ADDTOF 

TIME 

ABTCHK 

KTEST 

MI  SC 

RANDOM 

RPLCTN 

BDATA1 

ABRLBL 

LOGFLG 

ACHAR 

POINT 

DESRNG 

SMOKED 

D1SPLY 

STITLE 

FLTTIM 

SYMBOL 

FSRESP 

X VALUE 

BLOCHK 

BAIL 

KTEST 

RANGE 

RF-LC  TN 

TARGET 

TIME 

CCPlOT 

RIJNDAT 

COMMNT 

COMENT 

COPE 

ABRLEL 

FLTTIM 

SMOKED 

ACHAR 

FSRESP 

STITLE 

BAIL 

HEADNC 

SYMBOL 

DESRNG 

LOGFLG 

TIME 

DISPI.  Y 
POINT 

X VALUE 

DODF 

RPLCTN 

CREAD 

DODF 

HIT 

RANDOC 

RNCLOS 

RSPT  IM 

WEATHR 

DETCTN 

FLAG 

KTEST 

RANDOM 

RPLCTN 

RSPTIM 

TIME 

OF AULT 

DVALUE 

RIJNDAT 

DFCHK 

DODF 

WEATHR 

KTEST 

RANDOM 

RANGE 

RPLCTN 

TARGET 

OUST 

KTEST 

MI  SC 

RANDOM 

RPLCTN 

ECHO 

BAIL 

PEDESC 

RIJNDAT 

DODF 

RANDOC 

SMOKED 

FLAG 

RANGE 

TARGET 

HIT 

RECNAM 

TIME 

L  DC FLO 
RNCLOS 
WEATHR 

MI  SC 
RPLCTN 

EINDIT 

ACHAR 

ICODE 

INDEX! 

RIJNDAT 

SYMBOL 

GETRNG 

RANDOM 

RANGE 

RNCLOS 

RPLCTN 

TARGET 

TIME 

GETTIM 

FLAG 

TIME 

FSRESP 

KTEST 

LOGFLG 

RANDOM 

RPLCTN 

GETVIS 

RANDOM 

RANGE 

RPLCTN 

WEATHR 

HEADER 

BAIL 

OVER 

SMOKED 

COMENT 

PEDESC 

SYMBOL 

D I SPL Y 

RANGE 

TARGET 

FLAG 

RECNAM 

TIME 

HEADNC 

RPLCTN 

IJVALUE 

LOGFLG 
RSPT  IM 

HITCHK 

HIT 

TIME 

KTEST 

RANDOM 

RANGE 

RPLCTN 

RSPTIM 

HFADNG 


FLAG 

RIJNDAT 


TIME 

OVER 
R  v  P  TIM 

WEATHR 

RSPTIM 

M I  i. 
RIINDAT 

TARGET 


I DCHAR 


SYMBOL 


TABLE  10-1  COMMON  BLOCKS  IN  EACH  SUBPROGRAM  OF  THE  COPE  PROGRAM  -  CONTINUED 


SUBPROGRAM 

COMMON 

BLOCK'- 

1 N I  T  L  7 

ABORT 

U VALUE 

Ai'HAR 

PVAI  '  If'. 

FLAG 

1  CODE 

INDEX  1 

T  NPII'f 

ABORT 

BA  I L 

COME NT 

DESRNG 

PIS PL Y 

DODF 

FI  AC 

FLTJ TM 

NTT 

I  (  ODE 

INDEX  ] 

!  OGELG 

OVER 

PC PE SC 

POINT 

RANDOf: 

RANDOM 

RANGE 

RNGI  OS 

RPLl'TN 

RSPT  I  M 

RUN PAT 

SMOKED 

SYMBOL 

T  I  ME 

U VALUE 

WE A  T  HR 

i.OSCHK 

n.  ag 

T  IMF 

KTFST 

RAN DOC 

RANDOM 

RANGE 

RPI.CTN 

MIN' RN 

HU 

KTEST 

RANDOM 

RANGE 

RPLCTN 

TARGET 

NOR  EC 

1  COPE 

NUMB  I 

SYMBOL 

OUTPUT 

ABORT 

SCCSS 

A B REEL 

DO  nr 

FL.  AG 

KTE  ST 

RPLCTN 

PECHK 

FLAG 

HIT 

KTEST 

RANDOM 

RANGE 

RPLCTN 

TARGET 

TIME 

WE  A  T  HR 

RENAME 

X  VALUE 

bkchk 

HIT 

KTFST 

RANDOM 

FPL i'  TN 

SCCSS 

TARGET 

PPl  OT 

RUN PAT 

P SMOKE 

SMOKED 

WEATHP 

RE  I NT  Z 

ABORT 

KTEST 

RANDOM 

RPLCTN 

see  s$ 

RNDRE.L. 

KTEST 

MTSC 

RANDOM 

FPL  CTN 

PNG1  HK 

KTEST 

RANGE 

RPLCTN 

E  P  K  E  C 

CO  ME.  NT 

1  :GFl.I: 

SYMBOL 

SMOKE 

KTEST 

RANDOM 

RP...CTN 

SMOKED 

WE  AI HR 

TIMCHK 

FLAG 

KTEST 

RFL CTN 

T  I  ME 

TITLE 

RUNDAT 

STITLE 

USF  T 

DVAI..I.IE 

LOG  FI  G 

OVER 

i  "VALUE 

V  JS:.HK 

K  7  E  T 

RANGE 

RP!  C  IN 

WARNDO 

C  L  AG 

K  I E • T 

RANDOM 

RPLCTN 

rsptim 

TIMF 

RUNDAT 

DVAi.UE 
M  3  SC 
R EC NAM 
TARGt  T 

TARGET 

T  T  ME 

RUNDAT 

RSPT  I.  M 


TABLE  10-2 

SUBPROGRAMS  OF  COPE 

IN  WHICH 

EACH  COMMON 

BLOCK  OCCURS 

OMMON 

SUBPROGRAMS 

ABORT 

ABRTTL 

INITLZ 

INPUT 

OUTPUT 

RE  I  NT Z 

ABRLBI. 

BDATAl 

OUTPUT 

A  CHAR 

BDATA1 

P INBIT 

INTTLZ 

BAH 

BLOCH'' 

COPE 

ECHO 

HEADFR 

INPUT 

r  omen  r 

COMMNT 

HEADER 

I  NF  i.l  T 

SFPREC 

BESRNG 

BOAT A 1 

INPUT 

D I SPL  v 

I3DATA  1 

HEADER 

I  NPI.IT 

lion  r 

COPE 

CREAD 

DPCHK 

ECHO 

INPUT 

OUTPUT 

D  value 

DP  AULT 

INITLZ 

INPUT 

US  FT 

FLAG 

ABRTTL 

INPUT 

COPE 
LOSC HP 

DETCTN 

OUTPUT 

ECHO 

PECHK 

GETTIM 

TIMCHK 

HEADER 

WARNDO 

FI.TTIM 

BOAT  A 1 

INPUT 

FSRFSP 

BOAT  A 1 

GETTIM 

HEADNG 

EDATA1 

HEADER 

HIT 

CREAD 

ECHO 

HITCHK 

INPUT 

MINTRN 

PECHK 

I  CODE 

FIND  IT 

INITLZ 

INPUT 

NOREC 

INPF.  <  1 

FINDTT 

INITLZ 

INPUT 

KTEST 

ARTCHK 

LQSCHK 

RNGfHK 

BLOCHK 

MINTRN 

SMOKE 

DETCTN 

OUTPUT 

TIMCHK 

DFCHK 

PECHK 

VI  SC  HR 

DUST 

PKCHK 

WARNDO 

CFTTIM 

REINTZ 

LOGR.  G 

BOAT A 1 

ECHO 

GETTIM 

HEADER 

INPUT 

SEPREC 

MI  SC 

ARTCHK 

DUST 

ECHO 

HEADER 

INPUT 

RNDREL 

OVER 

ECHO 

HEADER 

INPUT 

USET 

PEDESC 

FOHO 

HEADER 

INPUT 

POINT 

DDATAJ 

INPUT 

R  -INDOC 

CREAD 

ECHO 

INPUT 

LOSCHK 

RANDOM 

ARTCHK 

HITCHK 

RNDREL 

BETCTN 

INPUT 

SMOKE 

DPCHK 

LOSCHK 

WARNDO 

DUST 

MINTRN 

GETRNC. 

PECHK 

GETTIM 

PKCHK 

RANGE 

EL.OCHK 

INPUT 

DPCHK 

LOSCHK 

ECHO 

M1NTRN 

GETRNG 

PECHK 

GETVIS 

RNGCHK 

HEADER 

VISCHK 

INITLZ 

F'KCHK 

HITCHK 

RNDREL 

US  FT 


GETVIS 

REINTZ 

HITCHK 
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TABLE  10-2  SUBPROGRAMS  OF  COPE  IN  WHICH  EACH  COMMON  BLOCK  OCCURS  -  CONT’D 


COMMON 

SUBPROGRAMS 

RECNAM 

ECHO 

HEADER 

INPUT 

RNCLOS 

CREAD 

ECHO 

GETRNG 

INPUT 

RPLCTN 

ABRTTL 

ECHO 

LOSCHK 

RNGCHK 

ARTCHK 

GETRNG 

MINTRN 

SMOKE 

P.I  OCHK 
GETTIM 
OUTPUT 
TIMCHK 

COPE 

GETVIS 

F'ECHK 

V 1 SCHK 

DETCTN 

HEADER 

PKCHK 

WARNDO 

DFCHK 

HITCHK 
RE  I  NT  7 

DUST 

INPUT 

RNUREL 

RSPTIM 

CREAD 

F'ECHK 

DETCTN 

WARNDO 

ECHO 

GETTIM 

HEADER 

HITCHK 

INPUT 

RUNDAT 

CCPLOT 

INPUT 

COPE 

OUTPUT 

DF  AULT 
PPL  OT 

ECHO 

TIT..E 

FIND  IT 

HFADER 

INITLZ 

SC  CSS 

OUTPUT 

PKCHK 

RE  I NTS 

SMOKED 

EDATAL 

ECHO 

HEADER 

INPUT 

PSMOKE 

SMOKE 

3  TITJ.  F 

BPATA1 

TITLE 

SYMBOL 

BEAT A i 

FIND  IT 

HEADER 

I  DC HAP 

1  NP  LIT 

NUMR  I C 

? EPRF c 

TARGET 

ELOCHK 

LOSCHK 

DFCHK 

MINTRN 

ECHO 

PECHK 

GETRNG 

PKCHK 

HEADER 

HITCHK 

INPUT 

TIME 

ADDTBR 

cftrng 

F'ECHK 

ADUTOF 
GETT  IM 
TIMCHK 

El  OCHK 
HEADER 
WARNDO 

COPE 

HITCHK 

DETCTN 

INPUT 

DrCHK 

LOSCHK 

ECHO 
MINT  f.'N 

U VALUE 

HEADER 

INITLZ 

INPUT 

USED 

WEATHR 

CREAD 

PSMOKE 

DFCHK 

SMOKE 

ECHO 

GETRNG 

GETVIS 

INPUT 

PECHK 

X VALUE 

BDATAt 

PENAME 

TABLE  10-3  COPE  EQUIVALENCE  CLASSES 


NAME 

(Name  of  First  Item) 

LENGTH 

Bias 

MEMBERS 
-  Name  - 

Length 

ACQDAT 

161 

0 

NRP 

1 

1 

NPP 

1 

2 

NRNGCL 

1 

3 

CRNGD 

22 

25 

SEGLOC 

121 

146 

RNGCLB 

11 

157 

VELTBL 

4 

(Occurs  in  subroutines 

CREAD  and  INPUT) 

AINVDA 

167 

0 

DLTT 

6 

6 

PKTBL 

20 

26 

NRNGTT 

1 

27 

RNGTTF 

20 

47 

TTF 

120 

(Occurs  in  subroutines 

CREAD  and  INPUT) 

D 

70 

0 

DVALUE 

70 

(Occurs  in  subroutine 

IN  PUT) 

DFSDAT 

31 

0 

DFDOKL 

30 

30 

NDFSP 

1 

(Occurs  in  subroutine 

CREAD  and  INPUT) 

I  CODE 

1 

0 

CODE 

1 

(Occurs  in  subroutines 

FINDIT,  INITLZ,  and 

INPUT) 

PEOATA 

4260 

0 

INDEX 

60 

60 

PETBL 

4200 

(Occurs  in  subroutines 

CREAD  and  INPUT) 

V 


TABLE  10-3  COPE  EQUIVALENCE  CLASSES  -  CONT'D 


NAME 

MEMBERS 

(Name  of  First  Item) 

LENGTH 

Bias 

Name 

Length 

PSTDAT 

41 

0 

NRNGPS 

1 

1 

RNGPST 

10 

11 

PSTTBL 

30 

(Occurs  in  subroutines 

CREAD  and  INPUT) 

RECODE 

8 

0 

WCODE 

1 

1 

ACCODE 

1 

2 

RSCODE 

1 

3 

DFCODE 

1 

4 

ROCODE 

1 

5 

PECODE 

1 

6 

PSCODE 

1 

7 

AICODE 

1 

(Occurs  in  subroutine 

(HEADER) 

RODATA 

22 

0 

TCRIT 

1 

1 

NPLOSR 

1 

2 

RNGPLS 

10 

12 

PRBLOS 

10 

(Occurs  in  subroutines 

CREAD  and  INPUT) 

RSPDAT 

49 

0 

BATRTM 

3 

3 

XMVADF 

2 

5 

DUMl 

1 

6 

BCSPTM 

4 

10 

XMTTIM 

4 

14 

TMEAN 

4 

18 

TSIGMA 

4 

22 

DETTMA 

20 

42 

NDT 

1 

43 

TRARRY 

6 

(Occurs  in  subroutines 

CREAD  and  INPUT) 
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TABLE  10-3  COPE  EQUIVALENCE  CLASSES  -  CONT'D 


NAME 

(Name  of  First  Item) 

LENGTH 

Bi  as 

MEMBERS 

Name 

Length 

'J 

(Occurs  in  subroutines 

70 

HEADER  and  INPUT) 

0 

UVALUE 

70 

WDATA 

193 

0 

PRCLCG 

1 

1 

PRCFLS 

2 

3 

PRGCFL 

22 

25 

W 

132 

157 

VIS 

11 

168 

CLOUD 

6 

174 

NCC 

1 

175 

NVL 

1 

176 

PASQL 

6 

182 

WNDSPD 

9 

191 

HUMID 

2 

(Occurs  in  subroutines 

CREAD  and  INPUT) 
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CHAPTER  11 


11.  FLOWCHARTS 

This  chapter  includes  flowcharts  of  the  COPE  main  program  and 
subroutine  INPUT.  Flowcharts  of  the  other  subroutines  are  not  included 
since  they  are  generally  simple  enough  to  understand  by  reading  the 
descriptions  in  chapter  9  and  studying  the  actual  program  code  with  the  aid 
of  the  glossary  of  variables  in  chapter  12. 

Several  conventions  are  observed  in  the  flowcharts.  First, 
connectors  on-page  are  indicated  by  circles  whereas  connectors  off-page  are 
indicated  by  pentagons.  Numbered  connectors  correspond  to  actual  statement 
numbers  in  the  program  code  whereas  letter  connectors  are  merely  flowcharting 
conveniences.  Each  STOP  block  in  the  flowchart  includes  the  section  number 
of  this  report  that  explains  that  stop. 

A  list  of  abbreviations  used  in  the  flow  charts  is  included  on 
che  next  page. 


ABBREVIATIONS  USED  IN  FLOW  CHARTS 


acq 

Acquisition 

CLGP 

COPPERHEAD 

C.O. 

Completely  obscured 

comt 

comment 

desig 

designator 

DF 

direct  fire 

dgt 

digi tal 

0.0. 

designator  operator 

F.E. 

fully  exposed 

fn 

function 

H.O. 

hull  defilade 

hdng 

heading 

KW 

keyword 

max 

maximum 

mo 

month 

msg 

message 

msn 

mission 

no 

number 

nt 

night 

opt 

option 

OW 

Option  word 

param 

parameteri zed 

pr 

priori ty 

prob 

probability 

rd(s) 

round [s ) 

resp 

response 

R.N. 

random  number (s) 

rng 

range 

SG 

shooting  gallery 

smk 

smoke 

supp 

suppression 

temp 

temporary 

tgt 

target 

vel 

veloci ty 

vis 

visibility 

w  / 

wi  th 

# 

number 
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Flowchart  of  Main  Program  of  COPE 
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FIGURE  11-1  Flowchart  of  Main  Program  of  COPE  (Page  3  of  5) 
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FIGURE  11-2  Flowchart  of  Subroutine  INPUT  of  COPE  (Page  4  of  15) 
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FIGURE  11-2  Flowchart  of  Subroutine  INPUT  of  COPE  (Page  6  of  15) 
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FIGURE  11-2  Flowchart  of  Subroutine  INPUT  of  COPE  (Page  10 


FIGURE  11-2  Flowchart  of  Subroutine  INPUT  of  COPE  (Page  11  of  IS) 
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FIGURE  11-2  Flowchart  of  Subroutine  INPUT  of  COPE  (Page  1?  of  IS) 
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FIGURE  11-2  Flowchart  of  Subroutine  INPUT  of  COPE  (Page  13  of  15) 
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FIGURE  11-2  Flowchart  of  Subroutine  INPUT  of  COPE  (Page  14  of  15) 
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FIGURE  LI-2  Flowchart  of  Subroutine  INPUT  of  COPE  (rage  15  of  15) 
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CHAPTER  12 


12.  GLOSSARY  OF  MAIN  COPE  PROGRAM  VARIABLES 

This  chapter  consists  of  a  glossary  of  variables  for  the  main 
COPE  program.  (Glossaries  for  the  PREPMS  and  PRBLOS  preprocessor  programs 
are  respectively,  included  in  sections  14.3  and  15.3.  No  glossary  is 
provided  in  this  report  for  the  PAM  preprocessor  program.) 

The  glossary  consists  of  an  alphabetical  list  of  the  variable 
names.  For  each  variable  name,  there  is  an  entry  giving  VARIABLE,  TYPE, 
COMMON  BLOCK,  UNITS,  and  DEFINITION, 

Under  the  VARIABLE  heading  is  the  variable  name  and,  if  the 
variable  is  an  array,  the  array  dimensions  are  given  in  parentheses  after 
the  name. 


Under  the  TYPE  column,  the  variable  type  is  given;  if  the  type  is 
omitted,  it  means  the  FORTRAN  type  default  is  in  effect  (i.e.,  a  variable 
beginning  with  letter  I,  J,  K,  L,  M,  or  N  is  integer  type  whereas  one 
beginning  with  any  other  letter  is  single  precision  real  type). 

Under  the  COMMON  BLOCK  column  is  the  name  of  the  common  block  (if 
any)  to  which  the  variable  belongs.  If  this  column  contains  "(LOCAL)",  it 
means  the  variable  is  a  local  variable;  if  it  contains  "(F.P.)",  it  means 
the  variable  is  a  formal  parameter  in  a  FUNCTION  or  SUBROUTINE. 

Under  the  UNITS  column  is  the  name  of  the  units  of  measure  in 
which  the  variable  is  to  be  given.  If  a  blank  occurs  in  this  column,  it 
means  that  the  variable  is  unitless. 

Finally,  under  the  DEFINITION  heading  is  a  brief  description  of 
the  variable. 
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(LOCAL)  UPPER  RANGE  PROBABILITY  OF  ENGAGEMENT  VALUE  WHEN  INTERPOLA¬ 

TING  WITH  RESPECT  TO  RANGE  IN  PROBABILITY  OF  ENGAGEMENT  DATA 
WITH  IMUTS=2. 


PRGCFL { 1 1 ,2)  WEATHR  PRGCFL(I.J)  IS  THE  PROBABILITY  OF  METEOROLOGICAL  VISIBILITY 

RANGE  LIMIT  I  GIVEN  CLOUD  FREE  LINE-OF-SIGHT  AND  CONDITION  J 
(J=l  INDICATES  CLOUD  CEILING;  J=2  INDICATES  SCATTERED  CLOUDS) 
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PSTVAL (3)  (LOCAL)  PSTVAL(I)  IS  THE  PROBABILITY  THAT  THE  TARGET  IS  IN  POSTURE  I 

WHERE  1=1,2  AND  3  RESPECTIVELY  INDICATE  THAT  THE  TARGET  IS 
COMPLETELY  OBSCURED,  FULLY  EXPOSED,  AND  HULL  DCFILADE. 


RECLBL (8)  DISPLY  RECLBL ( I )  IS  AN  ALPHANUMERIC  CODE  THAT  FORMS  PART  OF  THE 

RECORD  NAME  KEY  FOR  WORD  ADDRESSABLE  MASS  STORAGE  FILE  (TAPE 
11)  RECORDS  OF  TYPE  I.  (WHICH  CORRESPOND  TO  KEYWORD  20+1). 
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SMK5(3,3,2)  SMOKED  TYPE  2  SMK  SAME  AS  SMK2  EXCEPT  FOR  TYPE  2  SMOKE  ROUND 

ROUNDS 


TMEAN(2,2)  RSPTIM  SECONDS  TMEAN'I.J)  IS  THE  HE  AN  TIME  REQUIRED  TO  ENTER  COPPERHEAD 

EIRE  MISSION  REQUEST  IN  DIGITAL  MESSAGE  DEVICE  FOR  CONDITION 


(LOCAL)  SECONDS  FIRST  TIME  DELAY  COMPONENT  OF  DELTAT.  (ACCOUNTS  FOR  MULTIPLE 

VEHICLES  AND  MULTIPLE  ROUNDS).  ALSO,  NOMINAL  RESPONE  TIME 
VALUE  FOR  PRINTING  IN  COMMENT. 
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USMK{2)  UVALUE  USMK{ 1 )  IS  THE  NUMBER  OF  TYPE  1  SMOKE  ROUNDS  USED. 

USMK ( 2 )  IS  THE  NUMBER  OF  TYPE  2  SMOKE  ROUNDS  USED. 


<c 

o 


—J  CD 


UJ 

O  — 

CO 

LU 

CO 

Oica 

CD  _J 

< 

cc 

CC 

h- 

UJ 

u_  < 

o  u_ 

CC  cc 

CO 

<c 

O 

K- 

X 

o  — 

U - 12 

O-  X 

CO 

u_ 

Z 

r 

F— 

cc 

o  o  o  o 

< 

LU 

• 

UJ 

CC  <C 

CC  —  O 

X  to 

CC 

o 

cc 

-J 

cc 

UJ  > 

■ — -  O  1 —  o 

O 

Q 

o 

II  cc 

cc 

O 

CO 

O  UJ  — <  _l 

O  UJ 

a 

_J 

—  UJ 

o 

UJ 

u_ 

£  uj 

Z  h-  Q  O 

o  oc 

< 

CO 

o 

o 

X  F— 

—  uj  Z 

CC  O 

z 

z 

UJ 

z  < 

_j  x  o  o 

X  U- 

a 

< 

o 

< 

o 

—  o  z 

1—  UJ 

cc 

F— 

O  3 

1— 

QC 

1 

z  a 

UJ  * 

CO 

o 

< 

< 

< 

UJ  UJ 

O  — «  CO  CO 

a 

X 

•—  a: 

UJ 

>- 

> 

>  Z 

O  UJ 

— «  to 

< 

o 

o 

F— 

—  oc 

OU  Jh 

A  QC 

z 

cc 

CO 

40  Lu 

z 

t— 

CD  UJ 

33  O  C 

i—  UJ 

CD 

UJ 

CD 

z 

< 

-J 

1— I 

F— 

O  33  UJ  O 

. —  CO 

X 

O  CM 

X 

x 

X  z 

_J  F—  UJ  >— ■ 

_J  X 

O 

F— 

LU 

•  II 

o 

CO 

K-  * — « 

<_>  —  cc  a 

U-  33 

CC 

< 

Z 

1—  O 

_ i 

hU.2 

O  Z 

o 

LJ 

♦— 

CO 

3  • 

C  — J  — 

o 

o 

3 

F— 

C3  * 

CO 

*— « 

UJ 

CO 

<  o 

CC  X 

LU 

33 

2:  or 

<c 

O 

C2  Z 

z  33  CM 

O-  O 

CC 

UJ 

O 

O  UJ 

_J 

Z 

UJ  O 

UJ  O  O  H 

O 

T~ 

CC 

o  3: 

-J 

< 

3C  — 

>  Z  X  iC 

to  Z 

c 

1 — 

x 

u. 

<r  • 

CC 

o  F- 

— *  *—  o 

F—  < 

F— 

__l 

Z  33 

o 

o  < 

£  — 

CD  _J 

z  CC 

<C 

Lu 

to 

—«  to 

>- 

CO  O 

- - -  o  CO 

UJ 

o 

O 

O  < 

F— 

z 

UJZO 

X  UJ 

►—* 

o  cc 

F— 

O  O 

UJ  O 

>-  o  «a:  -j 

UJ  PM 

CC 

to 

uj  O 

z 

-J 

—1 

CO  o 

F— 

_J  — 

LU  — 

F— 

>- 

UJ  u. 

<c 

O  cc 

«— 1  O  A  UJ 

UJ  _! 

****  r— 

Z 

CO 

a. 

F— 

cc  UJ 

03 

z  or  _j 

_J  33  O  LU 

F— 

LU 

10 

CO 

O  X 

•a:  uj 

—  O  X 

u_  X 

<  UJ 

X 

o 

n 

UJ  F— 

CO 

O  X  bC 

CO  IF —  u_ 

o  cc 

uj  Cl. 

LJ 

LU 

>- 

1—  -3 

o 

1—  < 

*— 1 

i—  x 

<  o  — 

o 

3  < 

—1 

to 

c 

UJ 

o 

UJ  UJ 

>  • 

u  <  w 

CO  So 

X  z 

F-~ 

UJ 

X 

cc 

O  - 

£  3 

z 

<  LiJ  £L 

O  X  —  33 

33 

CC  ^-* 

cc 

CC  F— 

o 

—1  o 

X  3 

CC  ►—  _ 1  O 

1/10*-' 

o 

LU 

>- 

< 

<  3= 

X  uj 

•a:  —■ 

Lu 

Cl.  — •  __l 

F —  >- 

Lu  UJ 

< 

K*  CJ3 

ac 

K-  X 

O  1— 

z  o 

3  UJ  O 

UJ  C 

_ I 

1— 

cc 

33 

UJ 

’ — <  F — • 

— •  c 

F —  1 1  f 

UJ  O 

X  O  cc 

>- 

cc 

CO  Z 

x 

o  o 

2  >  Z 

x  cc  z:  co 

F—  UJ  CC 

UJ  LU 

X 

*=r 

O 

o 

UJ  Z 

o  — 

0  —  0 

HU<U 

CO  <C 

o  • 

F — 

O 

CC 

z 

X  — > 

_J  _J 

cc  cd  — 

X  oc  K- 

CO  o 

LU 

—  e? 

UJ 

< 

h* 

O  CL. 

U_  F— 

lO  * —  C 

•— «  ^  _ 1 

LU  CD 

X  LU 

LU 

►— 

UJ 

u_ 

X 

o 

CC  UJ 

Q  <C 

—  C  i-  o 

Lu 

X  < 

3  O 

CC 

z 

O- 

O- 

CO  UJ 

o  cc 

lx.  Z  _J 

UJ  F—  — 

^  o 

<  cc 

Z 

UJ 

co 

— <  CM 

_J  * 

>—  co 

UJ 

O  <  33 

"  ■  3  — O 

— ■  •  CD 

z  o 

O  tu 

_j 

• — '  II 

<c  z 

33 

1—  F- 

O 

iZ  -J  z 

CC 

F~ 

F—  _U 

C3 

y— 

—J  — * 

UJ  Z 

X  CO  _J 

»  O  •— *  — 

X  —  CL 

O  to 

< 

z 

> 

UJ 

CO 

cc 

►—  UJ 

x  uj 

F-  Q  <C 

O  Z  03  . 

33  “ 

CC 

>-  > 

> — ■ 

CD 

1 -  •> 

UJ  O 

cc 

o  z  o 

1/1  — IX 

O  CO 

<c  — 

v: 

33 

CC 

-J  >- 

1—  o 

to  — i 

UJ  cc 

X  33 

•—  >  CO  1)  CO 

Lu  >  O 

O  CO 

CC  33 

cc 

O' 

< 

UJ  <C 

<C  CC 

—  < 

X  33 

UJ  O  Z 

o  z  cc 

UJ  <c 

cc  O' 

o 

UJ 

h- 

3*  a 

33  Q- 

3>  > 

1—  o 

-J  cc  — 

3  X  > 

to  ^  Lu 

cc  X 

<  UJ 

3 

^  to 

\cO 

CO  o 

to  Q 

Cu  Z 

CC  Z 

LU  O 

UJ  O 

X 

X 

X 

1—  o 

1—  O 

UJ  LU 

LU  LU 

X  CO 

X  CO 

CO 

LU 

cc 

-J 

CC 

CC 

X 

-J 

O 

_l 

X 

LU 

< 

X 

X 

C 

< 

_1 

-U 

F— 

F— 

CD 

<-> 

F— 

V— 

z 

o 

•a: 

Cl 

CD 

< 

Z 

o 

c 

o 

o 

o 

Z 

1— 

UJ 

< 

—1 

LU 

UJ 

LU 

o 

LU 

CC 

to 

3 

CC 

3 

3 

-J 

WNDSPD (3,3)  WLATHR  WNDSPD(I.J)  IS  THE  PROBABILITY  OF  HAVING  JTH  WINDSPEED 

GIVEN  PASQUN-L  ATMOSPHERIC  STABILITY  CATEGORY  2*1  OR  2*1- 


GLOSSARY  -  CONTINUED 


^  U_  < 
Z  O  QC 


O  Jl 

go  o  <c  i 


DO- 

azo> 


X  O  o  , 
♦—  a  u_  ; 


<  o  •  1 
a:  ►—  -z> 
»-  <  , 
CC  LiJ  ( 
O  U  o.  | 

t—  a.  >- 
O  »—  . 
a 

LlJ  CC  Z  ' 

aoo 

K—  b—t 

ZD  <  (/U 

o-  z  oo  c, 

U  13«  . 

a:  —  2:  c 


h-  z:  o  1 
o  U_ 
LxJ  CC  C 

r  u.  « 


go  ac  o 
—  —  o  ; 


S  a:  c 
— 1  LU  o 
a.  >-> 
V-G--Z. 
SOD( 
X  o  2:  ( 


c  a  cc 

-  cl  — 

-  o 

X  QC  >- 
:  >■  u.  — . 


‘  O  LlJ 

<C  •  GO 

CC  h-  C 

C  O  O  C  O 
CL  CC  ♦—  Z 
o  —  t- 

-  u  a  &}  z 
Hljzzu 
z)  k  >-■  o  q; 

o  o  a: 

UJ  C  Z  ZD 

I  ^  O  D  U 
> —  «c  a.  * 
a  00  — «  z 

CC  LiJ  WJ  _ 

O  CC  CC  LlJ 
<JL  CC  — IQ 
UJ  O  CO  LU 

u  r  u  «  3 

o  * —  GO  O 
— i  CC  C/D  __J 

<C  ■ — '  LlJ  O  _ I 

>  CC  CO  CL  < 

uj  E 

u  r  d  _/  >- 

— I  C.  Z  _ i  _J 

co  —  <r  _j 

<  Uu  < 

3  L  Q  h-  Z 

o  O  o  o  h- 

-J  o  z  o 

—ICC  < 

<Ouh 
_  X  <  LO 


"  UuO  _j 

3>-u< 

UJ  a:  t-  > 

X  K-  - — »  O 
>—  GO  CM  Z  O 
Z  »- — ►— 
GO  O  -D 
*— »  O  *>  •  o 

—  O^-^o 

UJ  *  Cl 

•  =3  t  go 
o  O  _l  -  uj 

•  uj  cf  ►—  ct 

—  go  >  —  ct: 

* — -ZD  X  o 
u;  WO 

=>  CC  .  => 
WWW  WD 
<  h-  2:  <  UJ 
>  y  <  >  UJ 

X  Sz  xz 


2.  C  < 

<  >  >  > 

z  < 

uj  O  uj 
UJ  O  o 

— I  «C  Lk_  c 

99  1—  o  ♦— 

«c  z  z 


C3  t—  2:  u- 

UJ  C  =?  < 

2:  2:  z  s 

CC  CC  <  ac 

UJ  O  X  o 

• —  u_  c_  u_ 


CHAPTER  13 


13.  CONVERSION  TO  OTHER  COMPUTERS 

The  COPE  model  and  its  preprocessors  were  written  for  use  on 
the  US  Army  Ballistic  Research  Laboratories  Control  Data  Corporation 
CYBER  7G  (CDC  7600)  computer.  These  programs  use  some  of  the  features 
that  are  peculiar  to  CDC  machines.  This  chapter  points  out  some  of  the 
changes  to  COPE  and  its  preprocessors  that  will  be  required  to  convert 
them  to  run  on  other  machines. 

13.1  Conversion  To  Other  CDC  Computers. 

COPE  and  its  preprocessors  have  been  run  on  other  CDC  machines 
(a  CDC  6600  at  Aberdeen  Proving  Ground  and  a  CDC  6400  and  a  CDC  6500  at 
FT  Leavenworth,  KS). 

Two  changes  were  required.  The  first  was  to  change  the  Hollerith 
string  delimiters  from  ‘(single  quote)  to  whatever  the  host  machine  uses 
to  delimit  Hollerith  strings  ("  double  quote  on  the  FT  Leavenworth  machine, 
£  on  machines  using  CDC's  standard,  *  at  some  other  installations). 

This  includes  strings  on  STOP  statements. 

The  second  change  was  to  define  the  cotangent  function  in  PAM. 

The  BRL  CDC  machines  have  the  cotangent  (COT)  function  as  a  library 
function;  some  other  machines  do  not.  This  can  be  easily  fixed  by  defining 
COT(X)  =  1 . /TAN ( X )  as  an  in-line  or  statement  function  in  PAM.  Of  course 
an  alternate  fix  is  to  replace  each  occurrence  of  COT(X)  by  ( 1 . /TAN ( X ) ) . 

Once  these  changes  were  made,  the  COPE  program  and  its 
preprocessors  ran  without  any  trouble  on  the  other  CDC  machines. 

13.2  Conversion  To  Non-CPC  Computers. 

The  author  cannot  anticipate  every  problem  the  user  may  encounter 
in  converting  COPE  and  its  preprocessors  to  run  on  other  machines;  however, 
there  are  certain  changes  that  will  have  to  be  made  and  of  which  the 
author  is  aware.  The  only  machine  (other  than  the  CDC  machines)  that  the 
author  uses  to  any  significant  extent  is  the  UNIVAC  1108,  so  most  of  the 
comments  in  this  section  deal  with  changes  the  author  knows  will  have  to 
be  made  to  get  the  programs  working  on  the  UNIVAC  machines. 

13.2.1  Hollerith  Delimiters  and  STOP'S.  The  first  change  that 
may  be  required  is  to  change  the  Hollerith  string  delimiters  from  1  to 
whatever  is  used  on  the  host  machine. 

The  CDC  machines  allow  a  STOP  statement  with  a  message  (the 
message  is  in  Hollerith  string  delimiters  itself)  which  is  printed  when 
that  STOP  is  encountered.  Other  machines  may  allow  only  a  number  with 
the  stop,  only  a  shorter  message  (CDC  allows  up  to  70  characters;  UNIVAC 
allows  6  characters),  or  nothing  at  all.  So  depending  on  the  STOP 
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messages  allowed,  all  of  the  STOP  statements  in  COPE  and  its  preprocessors 
may  require  changes. 


13.2.2  A  FORMATS  and  Alphanumeric  Arrays.  The  CDC  machines 
use  a  60  bit  word~and  a  six  bit  character  code  so  that  each  word  holds 
10  characters.  Hence,  most  of  the  alphanumeric  reads,  writes,  encodes, 
and  decodes  use  A1Q  format  and  most  data  statements  use  1  OH  format  to 
set  alphanumeric  values. 

For  machines  that  use  shorter  words  or  8  bit  character  codes, 
the  number  of  characters  per  word  will  probably  be  fewer.  This  means 
that  the  AT 0  formats  in  COPE  and  its  preprocessors  (and,  indeed,  all  An 
formats  where  n>  number  of  characters  per  word  on  the  host  machine)  must 
be  changed.  A  similar  remark  applies  to  all  10H  (or  nil  with  n  as  above) 
formats  in  data  statements.  Reducing  these  formats  to  the  limits  of  the 
host  machine  will  sometimes  require  that  arrays  containing  the  alphanumeric 
data  be  redimensioned.  For  example,  the  B  array  in  subroutine  INPUT  is 
currently  dimensioned  B(3,1Q);  if  used  on  the  UNIVAC  1108  which  lias  6 
characters  per  word,  it  would  have  to  be  redimensioned  B(14,10)  so  that 
each  row  could  still  contain  a  full  card  image  (30  characters). 

13.2.3  Word  Addressable  Mass  Storage  Files.  The  CDC  system 
subroutines  to  open,  read  from,  write  to, "and  close  a  word  addressable 
mass  storage  file  are  respectively  OPENMS,  READMS,  WRITMS,  and  CLOSMS. 

The  array  INDEX! T ,  the  system  subroutine  SYSTEMC,  and  the  user  routines 
NOREC  and  N0REC2  are  also  connected  with  COPE's  use  of  word  addressable 
files. 


The  most  convenient  way  to  adapt  COPE's  handling  of  these  files 
to  the  host  machine  is  probably  to  write  subroutines  OPENMS,  READMS, 
WRITMS,  and  CLOSMS  that  use  the  host  machines  equivalent  file  type  and 
commands,  and  which  perform  the  same  operations  as  on  CDC. 

In  the  specific  case  of  the  UNIVAC,  for  example,  OPENMS  would 
be  a  subroutine  which  first  does  a  DEFINE  FILE,  then  reads  from  the  direct 
access  file  (using  UNIVAC  terminology  --  this  is  equivalent  to  the  CDC 
word  addressable  file)  the  current  values  of  the  INDXU  array.  Subroutine 
READMS  would  search  the  INDX11  array  for  the  desired  record  name  and  then 
when  the  name  was  found  and  the  corresponding  address  v  looked  up,  it 
would  do  a  READ  (11 ’v);  if  the  record  name  were  not  found,  NOREC  would  be 
called  (or  N0REC2  in  PREPMS).  Subroutine  WRITMS  would  add  a  record  a a  jo 
and  address  to  INDX11  (or  perhaps  just  modify  the  addresses  if  the  record 
name  were  already  present)  and  the  do  a  WRITE  (ll’v).  CLOSMS  would  do  a 
WRITE  (11  * v)  of  INUX11  to  TAPE  1 1 . 

Non-CDC  machines  may  also  require  redimensioning  of  INDX11  to 
allow  record  names  to  take  up  two  (or  more)  words  of  characters.  Also 
additional  bookkeeping  of  record  addresses  may  be  required  in  PREPMS. 
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The  calls  to  SYSTEKC  and  the  defining  of  I RAY  can  be  dispensed 
with  if  error  prints  are  added  that  occur  v/hen  attempting  to  read  a  non¬ 
existent  record. 

13.2.4  ENCODE  and  DECODE.  Although  most  computers  with  FORTRAN 
IV  compilers  have  ENCODE  and  DECODE  statement's,  there  are  some  that  may 
not  and  there  are  others  that  differ  from  CDC's. 

If  the  host  machine  does  not  have  ENCODE  and  DECODE  statements, 
it  would  probably  be  worthwhile  to  write  subroutines  that  perform  the 
functions  of  ENCODE  and  DECODE  and  then  replace  all  ENCODES  and  DECODES 
in  COPE  with  calls  to  those  subroutines. 

If  the  host  machine  has  ENCODE  and  DECODE  a  check  should  be 
made  to  see  that  they  take  the  same  arguments  in  the  same  order  as  the 
CDC  ENCODE  and  DECODE  statements  and,  if  not,  the  necessary  changes  should 
be  made. 


13.2.5  DATE  and  TIME.  CDC  has  two  subroutines  DATE  and  TIME 
that  respectively  give  an  8  character  date  and  a  9  character  time.  These 
are  only  called  to  obtain  date  and  time  values  to  be  printed  on  the  title 
page  of  the  output.  If  the  user's  computer  does  not  have  equivalent 
subroutines,  the  calls  to  DATE  and  TIME  may  be  deleted. 

13.2.6  STRACE.  The  subroutine  STRACE  causes  a  printing  of 
traceback  information  from  the  current  subroutine  back  to  the  main  program. 
This  information  gives  the  subroutine  and  line  from  which  STRACE  was 
called,  the  subroutine  and  line  from  which  that  subroutine  was  called, 

and  so  on  back  to  the  main  program. 

STRACE  is  available  on  both  CDC  and  UNIVAC  but  it  may  not  exist 
in  some  FORTRAN  implementations  (or  it  may  have  a  different  name).  In  either 
case,  the  user  will  need  to  check  this  point. 

13.2.7  EOF.  The  CDC  machine  has  a  function  called  EOF.  The 
value  of  EOF  ( I  UN  IT)  is  zero  if  the  end  of  file  has  not  been  encountered 
on  I/O  unit  I  UN  IT.  After  a  READ,  a  test  of  EOF  will  yield  a  non-zero 
value  if  the  end-of-file  on  that  I/O  unit  has  been  encountered. 

The  CDC  statements: 

READ  (IL'NIT,  100)  iolist 

IF  ( E OF ( I UN IT). NE .0.0)  GO  TO  99 

are  equivalent  to: 

READ  (IUNIT,  100,  END  =  99)  iolist 

on  most  other  machines. 


I 
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13.2.8  COTANGENT.  Tho  PAM  program  uses  the  cotangent  function 
(COT).  It  this  is  not  a  library  function  on  the  user's  computer,  then  it 
should  either  be  defined  as  a  function  (a  statement  function  or  external 
function)  or  else  each  occurrence  of  COT(X)  should  be  replaced  by  (l./TAN(X)). 

13.2.9  Im.n  FORMAT.  The  CDC  FORTRAN  includes  an  Im.n  format 
which  specifies  that  an  integer  is  to  be  written  right  justified  in  a 
field  m  characters  wide  with  a  minimum  of  n  characters  printed  (m  n). 

This  means  that  leading  zeros  are  generated  when  the  output  value  requires 
fewer  than  n  digits.  For  example,  if  an  integer  variable  with  value  23 
were  to  be  written  under  15.4  format,  the  result  would  be:  b0023. 

Here  b  represents  a  blank  so  we  have  a  field  width  of  m=5  with  n=4 
characters  printed  even  though  2  would  have  sufficed. 

The  Im.n  is  a  standard  format  in  FORTRAN  77,  but  since  COPE 
is  written  in  FORTRAN  IV  that  may  be  of  no  help  to  the  user  whose  FORTRAN 
IV  compiler  does  not  include  it.  On  some  machines  a  similar  format  (such 
as  the  UNIVAC  Jn  format)  may  be  substituted;  on  other  machines  the  user 
may  have  to  simulate  this  format  by  using  one  of  several  different  formats 
depending  on  the  number  of  digits  required  to  write  the  integer  value. 

13.3  GGAMA  Function  (IMSL). 

The  main  COPE  program  uses  the  International  Mathematical  and 
Statistical  Library  (IMSL)  function  GGAMA.  It  is  called  from  function 
GAMMA  which  is  in  turn  called  from  GETTIM  (it  is  used  when  the  third  method 
of  playing  response  time  is  used). 

If  the  IMSL  is  available  on  the  user's  computer,  then  it  should 
be  made  available  when  COPE  is  loaded  and  run. 

If  the  IMSL  is  not  available  to  the  user,  then  a  function  GCAMA 
should  be  written  by  the  user  or  obtained  from  another  library.  It  should 
take  a  random  number  seed  IRN,  an  alpha  parameter  value  (ALPHA),  and 
return  a  gamma  distributed  random  deviate  R  (with  os  =  ALPHA  and  6=1). 

The  arguments  IN  and  WK  are  arguments  used  by  the  IMSL  routine  and  may  or 
may  not  be  used  by  the  user's  GGAMA. 
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14.  PREPMS  PREPROCESSOR  PROGRAM 
14.1  General  Remarks 


The  PREPMS  preprocessor  program  perforins  three  functions: 

(1)  to  create  or  modify  records  on  the  word  addressable  data 
base  file  (TAPE  1 1 )  by  reading  input  cards  (or  card  images)  and  writing 
their  contents  (in  appropriate  format  and  order)  to  TAPE  11. 

(2)  to  generate  and  print  a  list  of  the  names  of  the  current 
records  on  TAPE  1 1 ,  and 

(3)  to  generate  and  print  a  list  of  the  PE  data  records 
currently  on  TAPE  11  along  with  their  respective  parameter  values  (see 
section  5.4  for  the  relation  of  9  parameters  to  PE  data  record  names). 

Because  the  PREPMS  program  is  quite  straightforward  in  design 
and  shares  many  subroutines  with  COPE,  it  is  not  documented  as  thoroughly 
as  the  main  COPE  program;  however,  this  chapter  gives  enough  information 
to  set  up  the  input,  understand  the  output,  and  general ly  understand  what 
the  program  does. 

A  re-reading  of  Chapter  5  may  be  helpful  in  understanding  what 

follows. 

14.2  PREPMS  Program  Design. 

The  PREPMS  program  consists  of  seven  subprograms:  the  main 
program  PREPMS,  the  block  data  subprogram  BDATA2,  the  subroutines  N0REC2, 
PENAME,  and  SEPRC2,  and  the  functions  IDCilAR  and  NUMRIC. 

The  subprograms  PENAME,  IDCHAR,  and  NUMRIC  are  identical  to  the 
subprograms  of  the  same  name  in  COPE.  BDATA2  is  merely  a  subset  of  BDATA1 
of  COPE;  that  is,  it  contains  data  statements  that  fill  in  the  three 
common  blocks  LOGFLG,  SYMBOL,  and  XVALUE  as  does  BDATA1 ,  but  it  does  not 
fill  in  any  of  the  other  common  blocks  of  BDATA1  as  they  are  not  needed 
by  PREPMS. 


The  subroutine  SEPRC2  is  nearly  identical  to  SEPREC  of  COPE. 

The  only  difference  is  that  the  message  about  sequence  numbers  in  columns 
73-78  of  the  input  cards  is  written  directly  to  OUTPUT  instead  of  encoded 
and  written  via  a  call  to  COMMNT. 

The  subroutine  N0REC2  is  called  (as  a  result  of  using  CDC's 
SYSTEMC  feature)  whenever  the  program  attempts  to  read  a  record  named 
OPTNNUMS  from  TAPE  11  but  does  not  fir  ich  a  record.  This  should  happen 
only  when  PREPMS  is  creating  a  new  TAPE  II;  when  PREPMS  is  modifying  an 
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Print  "Creation  Run" 
message 


Read  first  (next) 
card  from  Input 


'  End-of-file 
encountered  on  Input? 


STOP( normal) 


Does  this  card 
indicate  option  words 
are  to  he  read? 


Read  option  words  and 
write  them  to  both  TAPE 
11  and  Output 


Does  this  card  \ 

indicate  a  Mew  Record 
(data  block)  to  be 
read?  / 


Read  data  block  cards 
and  write  data  to  both 
TAPE  11  and  Output 


Doe.-,  this  card 
direct  that  a  record 
list  be  printed?  y 


Write  to  Output  a  list 
of  the  names  of  the  records 
on  TAPE  11 


Does  this  card 
direct  that  PE  data 
be  interpreted? 


to  Output  a  list  of 
rameter  values  for 
data  record  name  on 


»1»] 


existing  TAPE11,  there  will  already  be  an  OPTNNUMS  record  on  TAPE  11- 
When  no  such  record  is  found,  N0REC2  is  called;  it  then  prints  a  message 
saying  that  the  current  job  is  a  creation  run  and  allows  the  program  to 
continue. 

The  main  program  PREPMS  is  different  from  anything  in  COPE. 

Its  main  logic  flow  is  shown  in  Figure  14-1.  It  begins  by  initializing 
(via  DATA  statements),  calling  SYSTEMC  to  set  an  error  recovery  procedure, 
and  opening  the  file  TAPE11.  If  it  successfully  reads  the  record  named 
OPTNNUMS,  it  continues;  if  not,  N0REC2  is  called,  a  message  is  printed, 
and  execution  resumes.  Next  it  attempts  to  read  a  card;  if  successful, 
the  program  continues;  if  unsuccessful,  it  has  hit  the  end  of  file  and  a 
stop  with  normal  termination  message  is  issued. 


action  to 


The  main  program  examines  the  card  just  read  to  determine  what 
take  next.  Five  possibilities  exist: 


(1)  Fhe  card  indicates  a  set  of  option  words  follows.  In  this 
case,  the  option  words  are  read,  printed  on  OUTPUT  and  written  to  TAPE  11. 

(2)  The  card  indicates  a  new  record  is  to  be  read.  In  this 
case,  the  data  for  the  new  data  block  record  is  read,  printed  on  OUTPUT, 
and  written  to  TAPE  11. 

(3)  The  card  indicates  a  list  of  the  names  of  the  records 
currently  on  TAPE11  is  desired.  In  this  case,  such  a  list  is  generated 
and  printed  on  OUTPUT. 

(4)  The  card  indicates  PE  data  record  names  are  to  be  interpreted. 
In  this  case,  the  names  of  the  PE  data  records  currently  on  TAPE11  are 
examined  and  the  corresponding  parameter  values  are  determined.  A  list 

is  then  printed  giving  each  PE  data  record's  name  and  the  correspondi ng 
parameter  values. 


(5)  None  of  the  above  in  which  case  a  stop  with  error  message 


occurs. 


Note :  The  terms  INPUT  and  OUTPUT  refer  respectively  to  the  files 
TAPE5  and  TAPE6  which  correspond  to  I/o  units  5  and  6.  TAPE11  corresponds 
to  I/o  unit  11  and  is  another  name  for  the  word  addressable  data  base 
file.  Note  that  OUTPUT  (or  TAPES)  normally  corresponds  to  a  line  printer 
and  INPUT  (or  TAPE5)  corresponds  to  either  a  punched  card  reader  or  a 
mass  storage  file  of  card  images. 

14.3  Glossary  of  PREPMS  Variables. 


The  majority  of  the  PREPMS  variables  have  the  same  meaning  as 
their  namesakes  in  the  COPE  program.  Therefore,  the  glossary  in  this 
section  gives  definitions  only  for  those  variables  different  from  the 
main  COPE  model. 
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NREAD  INTEGER  (LOCAL)  NUMBER  OF  OPTION  WORD  CHARACTER  STRINGS  TO  BE  READ 

IN  THIS  SET  OF  OPTION  WORDS. 


GLOSSARY  OF  PREPMS  VARIABLES  -  CONTINUED 


To  find  the  definition  of  a  variable  in  PREPMS,  one  should 
first  look  in  the  glossary  of  this  section.  Then,  if  the  variable  is  not 
found,  look  in  the  glossary  of  COPE  variables  in  Chapter  12. 

Note  that  all  variables  in  common  block  SADARB  are  used  only 
with  the  SADARM  variant  of  COPE  (called  SOPE)  and  are  not  defined  herein. 

This  remark  also  applies  to  the  WPNDAT  array. 

14.4  PREPMS  INPUTS. 

The  PREPMS  inputs  are  divided  into  four  types: 

(1)  option  word  records 

(2)  data  block  records 

(3)  REPORT  RECORD  LIST  directives,  and 

(4)  INTERPRET  PEDATA  directives. 

The  second  type  (data  block  records)  is  further  divided  into 
eight  types  of  data  blocks.  The  sections  concerning  data  block  record 
types  (sections  14.4.2(1)  through  14.4.2(8) )  also  give  instructions  for 
setting  up  data  to  be  read  by  COPE  using  the  TEMPORARY  feature  (see 
section  4.5). 

Note  that  if  two  or  more  option  word  records  are  read  correspond! ng 
to  the  same  keyword  (see  section  14.4.1)  then  only  the  last  one  read  will 
have  any  effect.  Similarly,  if  two  or  more  data  block  records  are  read 
under  the  same  record  name,  only  the  last  one  read  will  be  retained  on  TAPE11. 
This  means  that  any  modifications  to  either  type  1  or  type  2  input  (as 
listed  above)  require  that  the  entire  desired  record  contents  be  read 
(not  just  the  additions). 

Also,  note  that  inputs  of  the  four  types  may  be  arranged  in  any 
order  provided  that  the  integrity  of  the  multiple  card  (or  card  image) 
input  types  (types  1  and  2)  is  preserved.  However,  types  3  and  4  only 
have  effect  on  the  file  (TAPE11)  as  it  exists  at  the  time  they  are 
encountered;  hence,  they  are  usually  put  at  the  end  of  the  input. 

14.4.1  Option  Word  Records.  Each  option  word  record  consists 
of  one  card  (or  card  image)  of  type  1  and  NREAD  cards  of  type  2  following 
the  type  1  card. 

The  general  form  of  the  type  1  card  is: 

OPTION  WORDS,  keyword,  m,  n 


OPTMDS,  keyword,  m,  n 


L 


! 


where:  keyword  is  replaced  by  the  character  string  giving  the  abbreviated 
form  of  the  keyword  to  which  the  option  words  are  to  apply; 

m  =  NREAO,  a  positive  integer  giving  the  number  of  type  2  cards 
to  be  read  for  this  option  word;  and 

=  N0PT1 ,  a  positive  integer  giving  the  keyword  number  (see 
section  5.3.9)  of  the  keyword  to  which  the  option  words  are  to  apply. 

The  general  form  of  each  type  2  card  is: 

mm,  nn,  Option  word  character  string 

where:  mm  =  NOPTWC,  the  number  of  the  option  word  choice  to  which  the 
character  string  belongs  (NOPTWC  is  a  positive  integer); 

nn  =  NOPTW,  a  positive  integer  equal  to  one  plus  the  number  of 
the  option  word  for  which  the  character  string  is  an  allowed  choice;  and 

Option  word  character  string  is  the  actual  character  string 
allowed  as  a  choice. 

The  subsequent  use  of  option  word  character  string  in  a  COPE 
run  as  a  choice  for  option  word  NOPTW-1  on  a  keyword  input  card  for 
keyword  number  N0PT1  causes  option  number  NOPTWC  to  be  activated  for 
option  word  NOPTW-1.  (See  example  in  section  5.3.8;  for  a  second  example, 
see  appendixes  C  and  D.) 

Note:  While  blanks  may  be  freely  inserted  in  COPE  inputs 
(keywords  and  option  words)  with  no  effect  (the  single  exception  being 
blanks  occurring  within  10  spaces  after  a  "$"  -  see  section  4.5.3),  there 
should  be  no  internal  blanks  in  the  character  strings  on  type  2  cards. 

Also,  no  more  than  2  option  word  character  strings  applying  to 
the  same  keyword  are  allowed  to  correspond  to  a  given  NOPTWC,  NOPTW  pair. 

Finally,  no  more  than  30  type  2  cards  are  allowed  with  any  type 

1  card. 

14.4.2  Data  Block  Records.  There  are  eight  data  block  record 

types: 

(1 )  Weather  data 

(2)  Acquisition  data 

(3)  Response  time  data 

(4)  Direct  Fire  Suppression  data 

(5)  Random  Occurrence  data 

(6)  PE  (probability  of  engagement  data) 

(7)  Target  Posture  Distribution  data 

(8)  Invariant  data 

f 


The  formatting  of  the  input  required  for  each  of  these  types  is 
presented  in  a  separate  subsection  of  this  section. 

Note  that  these  eight  data  blocks  correspond  exactly  to  the 
eight  data  blocks  that  can  be  used  with  the  TEMPORARY  option  in  COPE. 
Furthermore,  the  formats  used  by  COPE  under  the  TEMPORARY  option  and  by 
PREPMS  are  identical  except  for  the  first  card  (or  card  image)  of  each 
set.  The  sections  that  follow  give  the  set-ups  required  for  use  with 
either  program. 

The  first  card  (header  card)  in  each  case  is  free  format:  blanks 
may  be  freely  inserted,  fields  are  defined  by  separators  (commas,  for 
example).  Subsequent  cards  of  each  data  block  type  are  formatted  FORTRAN 
inputs  and  care  must  be  taken  to  conform  to  the  specified  formats. 

1 .  Weather  Data  Block  Input. 

When  reading  weather  data  into  PREPMS  for  transfer  onto  TAPE 7  7, 
the  first  card  (which  indicates  a  weather  data  record  is  to  be  input) 
must  be  of  the  form: 


NEW  RECORD,  record  name,  1 


or 

NEW  REC,  record  name,  1 


where  record  name  is  the  name  of  the  weather  data  record  to  be  read. 

(See  section  5.3.1  for  the  form  of  weather  data  record  names). 

When  using  the  TEMPORARY  option  with  COPE,  the  weather  data  is 
headed  by  a  card  of  the  form: 

TEMPORARY,  WEATHER  or  TEMPORARY,  W 


or 

TEMP,  WEATHER  or  TEMP,  W 

In  either  case  (whether  reading  weather  data  in  PREPMS  or  COPE), 
the  remaining  cards  of  the  weather  data  are  as  follows: 
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WEATHER  DATA 


CARD  SET 


Card  No. 


2 


Variable  name 


NCC 


NVL 


UNITS 


Format 


15 


15 


col umns 


1-5 


6-10 


14-9 


Description 


Number  of  different  cloud  ceiling 
altitude  values  used  with  the  current 
weather  data.  (If  NCC  >6,  then  array 
dimension  changes  are  required' 

Number  of  different  visibility  range 
limits  used  with  the  current  weather 
data.  (If  NVL*  11,  then  array  di¬ 
mension  changes  and  program  modi  flea 
!  tions  are  usually  required). 


MiMMI 


Variable  name  UMITS 


columns  description 


LEATHER  OATA  CARO  SET 


Card  Ho. 


Variable  name 


UNITS 


Format 


columns 


PRGCFtO  ,1 ) 


PRGCFl(2,l) 


ft  a.  4 


F10.4 


l-ia 


11-21 


Description 


PRGCFLCI  ,1 )  Is  the  probability  that 
the  visibility  range  limit  is  equal  to 
I  kilometers  given  that  there  is  a 
cloud  ceiling  and  a  cloud  free  line-of- 
sight. 

‘lote :  The  visibility  range  limit 
is  considered  to  be  I  kilometers  if 
(I-l/2)km  <  visibility  range  limit 
<(f+T/2)fai. 


PRGCFL(8,1) 


0 


WEATHER  DATA 


CARD  SET 


Card  No.  4b 


Variable  name 

UNITS 

Format 

columns 

bescription 

PRGCFl(9,1 ) 

1 

? 

I 

; 

t 

FI0.4 

T-1Q 

PRGCFL(I.I)  it  described  on  previous 
page. 

prgcflOi  ,i) 

l 

1 

1 

no.  4 

i  21-30  : 

L 


Variable  name  I  UNITS 


PRGCFlO ,2) 


PRGCFL(2 ,2 ) 


''escription 


PRGCFL( I ,2 )  is  the  probability 
that  the  visibility  range  limit  is 
equal  to  I  kilometers  given  that  there 
is  no  cloud  ceiling  and  that 
there  is  a  cloud  free  line-of-sight. 
The  note  on  card  4a  applies. 


PRGCFL(8,2) 


I  77-80 


■a»  if  ' 


WEATHER  DATA 


CARD  SET 


Card  No-  6c  -  Ck 


Cards  6c  through  6k  are  similar  to  cards  6a  and  6b  except  each 


successive 

card  contains 

W(I,J,1)  values 

for  a  higher 

value  of  J: 

card 

6a 

contains 

W(l,l,l) 

through 

W  ( 6 , 1  , 1 ) 

it 

6b 

ii 

W(1 ,2,1 ) 

il 

W(6 ,2 ,1 ) 

ii 

6c 

M 

W(1 ,3,1 ) 

ll 

W(6,3,l ) 

li 

6d 

n 

W(1 ,4,1 ) 

ll 

W(6,4 , 1 ) 

ii 

6e 

ll 

W(1  ,5,1 ) 

ll 

W(6,5,l) 

il 

6f 

i< 

W(1 ,6,1 ) 

ll 

W(6,6,l) 

il 

6g 

ii 

W(1 ,7,1 ) 

li 

W(6, 7, 1 ) 

U 

6h 

it 

W(1 ,3,1 ) 

ll 

W(6,8,l) 

ll 

61 

ll 

W(1 ,9,1 ) 

ll 

W(6,9,l) 

il 

6j 

ii 

W(1 ,10,1 ) 

H 

W(6,10,l ) 

li 

6k 

ii 

wd.ii.D 

n 

W(6,l 1,1) 

Each  of  these  cards  contains  six  values, 

jw(l,J,l),  W(2,J ,1 ) ,  W(3,J ,1 ) ,  W(4,J ,1 ) ,  W(5,J , 1 ) ,  and  W(6,J,1)J  , 

in  6F10.4  format  (exactly  as  illustrated  for  cards  6a  and  6b  on  the 
previous  two  pages). 

1 


WEATHER 

DATA 

CARD 

SET 

Card 

No.  7c  - 

7k 

Cards  7c  through  7k  are 

similar  to  cards 

7 a  and 

7b  except  each 

successive 

card 

contains  W 

'I,J,2)  values  for 

a  higher  value 

of  J: 

card  7a 

contains 

W(U,2) 

through 

W(6,l,2) 

"  7b 

it 

W(l,2,2) 

il 

W(6,2,2) 

"  7c 

H 

W(1 .3,2) 

ll 

W(6,3,2) 

"  7d 

II 

W(l,4,2) 

il 

W(6,4,2) 

"  7e 

il 

W  { 1 .5,2) 

il 

W(6,5,2) 

11  7f 

ii 

W(  1 ,6,2) 

il 

W(6,6,2) 

"  7g 

li 

W ( 1 ,7,2) 

ll 

W(6,7,2) 

"  7h 

ll 

W{1 ,8,2) 

il 

W( 6,8,2) 

“  71 

ll 

M(1 ,9,2) 

ll 

W(6,9,2) 

"  7j 

ll 

W(1 ,10,2) 

ll 

W(6,10,2) 

"  7k 

H 

w(i,n,2) 

ll 

W(6,l 1 ,2) 

Each  of  these  cards  contains  six  values, 

|w(l,J,2),  W(2,J,2),  W(3,J,2) ,  W{4,J,2),  W(5,J,2),  and  W(6,J,2)j, 

in  6F10.4  format  (exactly  as  illustrated  for  cards  7a  and  7b  on  the 
previous  two  pages). 
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WEATHER  DATA 


CARD  SET 


Card  No. 


8a 


Variable  name 

UNITS 

Format 

columns 

description 

VISLIM(I) 

km. 

i  FI 0.4 

~  ! 

VISUM  (I)  is  the  I th  visibility 
range  limit  value. 

VISUM  (2) 

km. 

1  FI  0.4 

1 

n-20 

Any  choice  other  than  VISLIM(I)  *  I 
kilometers  will  require  program 

VISUM  (3) 

I 

• 

, 

km. 

t 

1 

no. a 

i 

i 

21-30 

j 

1 

changes  to  COPE* 

, 

1 

VISUM  (8) 

km. 

i 

i 

FI  0.4 

1  : 

1 

1 

'  71 -SO 

i 

t 


i 


I 

l 

l 


l 
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WEATHER  DATA  CARO  SET  Card  No. 


Variable  name 

UNITS 

- 1 

Format 

col  umns 

description 

CLOUD  (1 ) 

meters 

FI  0.4 

1-10 

CLOUD  (I)  Is  the  Ith  cloud  celling 

altitude  In  meters  used  for  the 

current  set  of  weather  data. 

CLOUD  (2) 

meters 

FI0.4 

11-20 

CLOUD  (3) 

meters 

F10. 4 

21-30 

CLOUO  (4) 

meters 

1  FI  0.4 

31-40 

1 

' 

« 

CLOUD  (5) 

meters 

F10.4 

41-50 

! 

• 

CLOUD  (6) 

meters 

i 

j  FI 0.4 

\ 

i 

51-60 

|  i 

1 

i 

' 

' 

10 


WEATHER  OATA  CARD  SET 


Card  No. 


Variable  name 

UNITS 

Format 

- 1 

columns  | 

description 

PASQL  (1) 

FI  0.4 

1-10 

PASQL(I)  is  the  probability  of 
occurrence  of  the  Ith  Pasquill 

atmospheric  stability  category. 

PASQL  (2) 

no. 4 

11-20 

(Category  A  corresponds  to  1*1 , 

B  to  1=2,  etc.) 

PASQL  (3) 

no. 4 

21-30 

PASQL  (4) 

1  FI  0.4 

31-40 

' 

PASQL  (5) 

F10.4 

j  41-50 

i 

1 

l 

PASQL  (6) 

1 

1 

no. 4 

;  51-60 

i 


i 

1 


l 

I 

i  i 

I 

!  I 
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Variable  name  UNITS 


columns 


hescri  ption 


HUMID  (1)  is  the  probability  that  the 
relative  humidity  is  less  than  65*; 
HUMID  (2)  is  the  probability  that 
the  relative  humidity  is  greater  than 
(or  equal  to)  65*. 


2.  Acquisition  Data  Block  Input. 


When  reading  acquisition  data  into  PREPMS  for  transfer  onto 
TAPE11,  the  first  card  (which  indicates  an  acquisition  data  record  is 
to  be  read)  must  be  of  the  form: 

NEW  RECORD,  record  name,  2 

or 

NEW  REC,  record  name,  2 

where  record  name  is  the  name  of  the  acquisition  data  record  to  be 
read  (see  section  5.3.2  for  the  form  of  acquisition  data  record 

names ) . 

When  using  the  TEMPORARY  option  with  COPE,  the  acquisition 
data  is  headed  by  a  card  of  the  form: 

TEMPORARY,  ACQUISITION  RANGE  DISTRIBUTION 
or 

TEMPORARY,  ACQRNGOIST 
or 

TEMP,  ACQUISITION  RANGE  DISTRIBUTION 
or 

TEMP.  ACQRNGDI5T 

In  either  case  (whether  reading  acquisition  data  in  PREPMS 
or  COPE),  the  remaining  cards  of  the  acquisition  data  are  as  follows: 


Variable  name 


columns 

description 

5 

i 

1-5 

Number  of  range  points  used  in  the 
CRN6D  array  (Cumulative  distribution 
of  acquisition  (unmasking)  ranges.) 

5 

5-10 

Number  of  points  used  within  each 
range  class  to  describe  cumulative 
distribution  of  line-of-sight 
segment  lengths. 

:s 

11-15 

i 

Number  of  range  class  boundary  value 
to  be  used  (equals  one  less  than 
the  number  of  range  classes) 

Note:  Zero  is  always  assumed  to  be 
the  lower  boundary  of  the  shortest 
range  class  so  it  need  not  be 
explicitly  entered  as  input  nor 
counted  as  a  boundary  value  for 

ACQUISITION  DATA 


Card  No.  3 a 


ACQUISITION  DATA 


CARD  SET 


Variable  name 


columns 


CRNGD(1,2) 
CRNGD ( 2,2) 


CRNGD(8,2) 


meters 

i 

l 


i  no. 4 


i  71-80 


Card  No.  3b 


description 


CRNGD(I,2)  is  the  range 
value  corresponding  to 
the  cumulative  probability 
value  in  CRNGD(I.l). 

The  values  must 
increase  as  I  increases. 


Note:  If  NRP  <  8,  only  one  card  of 
this  type  will  be  needed;  if 
NRP  >  8,  then  a  second  card 
must  continue  with  CRNGi  J,2) 
through  CRNGD(NRP,2)  NRP  cannot 
exceed  11  with  current 
dimensions. 
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Variable  name 


columns 


'escri  ption 


SEGLOS(l.l) 
SEGLOS  ( 2  ,1 ) 


SEGL0S(8,1 ) 


F10. 4 

F10.4 

i 

i 

i  I 

/  i 

/ 

I 

i  i 

/  I 

i 

F10.4 


1-10 

11-20 


71-80 


SEGL0S(I,1)  is  the  probability 
that  the  length  of  a  line-of-sight 
segment  in  range  class  K  is  ,ess 
than  or  equal  to  SEGLOS  (1.  K+l) 
meters. 

Note: 

SEGLOS  ( 1  ,1)  =  0.0 
SEGLOS (NPP,1 }  =  1.0  and 
SEGLOS ( 1 ,1  )<  SEGLOS ( I  +1,1) 
for  1  =  1 ,2,  —  NPP-1 . 


If  NPP  <8,  only  one  card  of  this  type 
will  be  needed;  if  NPP  >8,  then  a  second 
card  must  continue  with  SEGLOS  (9,1) 
through  SEGLOS (NPP , 1 ) .  NPP  cannot  exceed 
11  with  current  dimensions. 


Variable  name 


UNITS 


Format 


col  umns 


nescription 


SEGLOS (1 ,2) 

meters 

F10.4 

1-10 

SEGLOS ( I ,2)  is  the 
line-of-sight  segment  length 

SEGL0S(2,2) 

meters 

F10.4 

11-20 

value  corresponding  to  the 
cumulative  probability  value 

SEGL0S(2,3) 

\ 

meters 

FI  0.4 

21-30 

in  SEGLOS (1,1)  when  the 

/ 

/ 

range  from  D.O.  to  target 

t 

/ 

l 

unmask  falls  in  the  first 

l 

j 

/ 

/ 

1 

1 

range  class. 

/ 

1 

t 

1 

1 

Note: 

/ 

l 

i 

SEGL0S(I ,2)<  SEGLOS (1+1,2) 

l 

i 

; 

1 

! 

for  I  =  1,2,—  ,  NPP-1 . 

Note: 

if  NPP  <8,  only  one  card  of  this  type  i 
needed;  if  NPP  >8,  then  a  second  card 
mist  continue  with  SEGL0S(9,2)  through 
3EGL0S(NPP ,2 ) .  NPP  cannot  exceed  11  wit 
current  dimensions. 

ACQUISITION  DATA  CARO  SET  Card  No.  4c  -  4k 


The  SEGLOS  array  is  read  from  additional  cards  similar  to 
4b  up  to  a  maximum  of  11  cards  (or  card  pairs  if  NNP  >8). 

Each  card  (or  card  pair  if  NPP  >8)  has  the  following  content: 


card  4a 

contains 

SEGLOS (1 ,1 ) 

through 

SEGLOS(NPP.l) 

"  4b 

H 

SEGL0S( 1,2) 

SEGLOS (NPP, 2) 

"  4c 

II 

SEGL0S(1  ,3) 

SEGL0S(NPP,3) 

"  4d 

II 

SEGL0S( 1  ,4) 

SEGL0S(NPP,4) 

"  4e 

II 

SEGLOS (1  ,5) 

SEGLOS(NPP ,5 ) 

"  4f 

II 

SEGL0S(1 ,6) 

SEGL0S(NPP,6) 

"  4g 

II 

SEGLOS ( 1 ,7) 

SEGLOS(NPP  ,7 ) 

"  4h 

II 

SEGL0S(1  ,8) 

SEGLOS(NPP ,8) 

"  4i 

II 

SEGLOS ( 1  ,9) 

SEGLOS(NPP  ,9) 

"  4j 

II 

SEGL0S(1 ,10) 

SEGLOS(NPP.IO) 

"  4k 

II 

SEGLOS (1 ,11) 

SEGLOS(NPP.ll) 

If  NPP  >8  then  each  card  above  is  replaced  by  a  card  pair.  In 
this  case,  the  first  card  of  each  pair  contains  eight  values  and 
the  second  card  contains  NPP-8  values  (each  card  is  in  8F10.4  format). 
SEGL0S(1,J)  through  SEGLOS(NPP.J)  contain  (for  J>2)  the  1 i ne-of-sight 
segment  lengths  in  meters  for  range  class  J-l  correspond! ng 
respectively  to  the  cumulative  probability  values  in  SEGLOS (1,1)  through 
SEGLOS ( NPP,1 ).  The  total  number  of  cards  (or  card  pairs  if  NPP>8)  will 
be  NRNGCL  +  1  (one  for  probabilities  plus  one  for  each  range  class). 
Hence,  if  NRNGCL  =  10,  all  cards  3a  through  3k  will  be  used;  but,  if 
NRNGCL  <10,  then  only  the  first  NRNGCL  +  1  cards  (or  card  pairs  if 
NPP  >8)  shown  above  will  be  used. 
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Variable  name  UNITS  Format  columns  description 


RNGCLB(l) 

meters 

F10.4 

1-10 

RNGCLB(I)  is  the  1th  non-zero 
range  class  boundary.  That 

RNGCLB(2) 

/ 

meters 

1 

FI  0.4 

i 

11-20 

1 

is,  range  class  1  runs  from 
zero  to  RNGCLB ( 1 )  meters 
and,  for  I  >  1,  range  class 

1 

i 

' 

' 

I  runs  from  RNGCLB ( I - 1 ) 

1 

1 

i 

1 

l 

1 

1 

1 

meters  to  RNGCLB(l)  meters. 

(When  the  00rto-target 
unmask  range  lies  in  range 
class  I,  then  the  (I  +  l)st 

RNGCLB  (8) 

meters 

F10.4 

71-80 

row  of  the  SEGLOS  array 
is  sampled  to  obtain  LOS 
segment  lengths.) 

Note  that 

0  <RNGCLB(1 )<...  <RNGCLB( I ) 

...  < RNGCLB ( I+l  )<... 

Also  note  that  if  NRNGCL  <8, 

;  then  only  one  card  of  this  type 
!  i s  needed;  but,  if  NRNGCL>  8, 
i  then  a  second  card  must  continue 
with  RNGCLB(9)  through 
RNGCLB( NRNGCL).  Finally, 

RNGCLB  cannot  exceed  10  with 
current  dimensioning. 


ACQUISITION  DATA 


CARO  SET 


Card  No .  6a 


Variable  name  UNITS 


columns 


description 


ACQUISITION  OATA _ CARD  SET 


Card  No. 


6b 


Variable  name 


UNITS 


Format 


col umns 


'iescri  ption 


When  reading  response  time  data  into  PREPMS  for  transfer  to 
TAPED,  the  first  card  (which  indicates  that  a  response  time  data  record 
is  to  be  read)  must  be  of  the  form: 

NEW  RECORD,  record  name,  3 
or 

NEW  REC,  record  name,  3 

where  record  name  is  the  name  of  the  response  time  record  to  be  read 
(see  section  5.3.3.  for  response  time  record  names). 

When  using  the  TEMPORARY  option  with  COPE,  the  response  time 
data  is  headed  by  a  card  of  the  form: 

TEMPORARY,  RESPONSE  TIME 
or 

TEMPORARY,  RE5PTIME 
or 

TEMP,  RESPONSE  TIME 
or 

TEMP,  RESPTIME 

Note:  When  the  first  method  (section  2.2.9)  of  modeling  delay 
times  in  COPPERHEAD  mission  communication  and  processing  is  played,  in  COPE, 
the  response  time  distribution  used  is  the  one  defined  by  data  statements 
in  BDATA1  (namely,  the  FSRT  array  -  see  section  4.7.6). 

Because  this  array  is  sampled  to  obtain  response  times,  the 
values  on  cards  4,  5,  and  6  of  this  card  set  are  not  used.  However, 
cards  must  still  be  input  (though  they  may  be  blank)  so  that  the  statements 
which  read  the  later  cards  of  this  set  will  pick  up  the  correct  data. 

The  record  name  used  with  the  data  for  the  first  method  of 
playing  response  time  must  be  RSPDAT0123  unless  one  makes  code  changes 
in  COPE  to  allow  for  others. 

In  any  case  (whether  reading  response  time  data  in  PREPMS  or 
COPE),  the  remaining  cards  of  the  response  time  data  are  as  follows: 


RESPONSE  TIME 


CARO  SET 


Card  No .  3a 


Variable  name 

UNITS 

Format 

col  unins 

description 

-- 

DETTMA  (1  .1  ) 

FI  0.4 

DETTMA  (1,1)  is  the  probability 
that  the  "detection"  time  is  less 

OETTMA  (2,1) 

FI  0.4 

11-20 

than  or  equal  to  DETTMA(I,2)  seconds. 

1 

1 

1 

•  ! 
' 

Note : 

DETTMA  (1  ,1  )  »  0.0  and 

1 

i 

1 

i 

DETTMA  (I )<  DETTMA  (I  +1) 

DETTMA (8,1 ) 

j  FI 0.4 

i 

i 

1 

!  71-80 

l 

1 

| 

Also  note  that  if  NDT  -'8,  only 
one  card  of  this  type  is  required; 

!  if  NOT--  8,  then  a  second  card  is 

1  required  with  DETTMA  (9,1)  through 
!  DETTMA  (NDT.l). 

I  j 


I 

i 


i 


! 

i 

i 
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L*. 


id  HiTliiUMrittHl  P 


Variable  name 


UNITS 


Format 


col  umns 


description 


RESPONSE  TIME  CARD  SET  Card  No.  _ ! 


Variable  name 

- 1 

UNITS 

’  '  '  1 
Format 

col urnns 

description 

BATRTM  (1) 

seconds 

no. 4 

1-10 

BATRTM  (I)  is  the  response  time 
at  the  battery  for  a  Copperhead 
mission  of  type  I . 

BATRTM  (2) 

seconds 

no. 4 

n-20 

I  *  1  for  preplanned  targets 

BATRTM  (3) 

seconds 

no. 4 

21-30 

I  »  2  for  targets  of  opportunity 

I  *  3  for  priority  preplanned  targets 

XMVADF  (1) 

seconds 

j  no. 4 

| 

;  31-40 

j  XMVADF  (I)  is  the  time  required 
!  to  transmit  message  via  voice 
j  conrno  after  falling  to  transmit 
!  via  digital  conrno. 

XMVADF  (2) 

seconds 

i  no. 4 

1 

i 

1  41-50 

1 

I  *  1  for  pre-planned  targets 
(priority  or  not) 

I  *  2  for  targets  of  opportunity 

Note:  The  first  way  of  modeling  delay 
times  does  not  use  the  data  on  cards 
4,  5,  and  6;  hence,  they  may  be  left 
i  blank. 

|  The  second  way  of  modeling  delay 

j  times  does  not  use  any  RESPONSE  TIME 
: data  block  values,  so  no  record  is 
prepared  corresponding  to  the  PARAM 
, option. 

Finally,  the  third  delay  time 
model  uses  all  data  in  the  data  block, 
i  See  sections  2.2.9,  4.4.15  and 

|  9.23  for  further  details  on  the  three 

i  delay  time  models. 


I 


1 

! 


RESPONSE  TIME  _ CARD  SET  Card  No.  _5 


Variable  name 

UNITS 

Format 

columns 

bescri  ption 

3CSPTM  (1  ,1) 

seconds 

FI  0.4 

1-10 

BCSPTM  (I.J)  is  the  battery  com¬ 
puter  system  processing  time  for 

BCSPTM  (2.1) 

seconds 

FI  0.4 

11-20 

commo  type  I  and  mission  type  J. 

BCSPTM  (1.2) 

seconds 

no. 4 

21-30 

I-  *  1  for  digital  commo 

I  =  2  for  voice  cornno 

BCSPTM  (2,2) 

seconds 

F10. 4 

31-40 

i  i 

J  *  1  for  pre-planned  target 
(priority  or  not) 

J  *  2  for  target  of  opportunity 

XMTT1H  (1.1) 

seconds 

FI  0.4 

41-50 

i 

XMTT1M  (I.J)  is  the  commo  trans- 
!  mission  time  for  commo  type  I  and 

XMTT1M  (2.1) 

" 

no. 4 

|  51-60 

1 

and  mission  type  J  where  I  and  J 
are  as  for  BCSPTM  above. 

XMTT1M  (1.2) 

no. 4 

,  61-70 

XMTT1M  (2.2) 

i 

1 

1  no. 4 

,  71-80 

1 

I 

I 


RESPONSE  TIME  _ card  sgj  Card  No. 


Variable  name 

UNITS 

Format 

col  umns 

'description 

TMEAN  (1  ,1 ) 

seconds 

FI  0.4 

1-10 

TMEAN  (I,J)  is  the  mean  time  for 

DO  to  enter  data  in  the  digital 

TMEAN  (2,1) 

seconds 

no. 4 

11-20 

message  device  in  day/night  condition 

I  and  mission  type  J. 

TMEAN  (1,2) 

seconds 

no. 4 

21-30 

I  *  1  for  day  time 

I  »  2  for  night 

TMEAN  (2,2) 

seconds 

no. 4 

31-40 

J  *  1  for  pre-planned  target 
(priority  or  not) 

J  =  2  for  target  of  opportunity 

TSIGMA  (1,1) 

seconds 

FI  0.4 

41-50 

TSIGMA  (I,J)  is  the  standard 
deviation  of  the  distribution  of 

TSIGMA  (2,1) 

seconds 

FI  0.4 

51-60 

times  required  for  the  DO  to  enter 
data  in  digital  message  device  under 

TSIGMA  (1,2) 

seconds 

FI  0.4 

61-70 

day/night  condition  I  and  mission 
type  J. 

TSIGMA  (2,2) 

seconds 

FI  0.4 

71-80 

I  and  J  are  as  defined  above  for 

TMEAN. 

RESPONSE  TIME 


CARD  SET 


Card  No. 


Variable  name 

UNITS 

Format 

columns 

Description 

TRARRY  (1,1) 

seconds 

F10. 4 

1-10 

TRARRY  ( I , J)  is  the  nominal 
response  time  for  mission  type  I 

TRARRY  (2,1) 

seconds 

no. 4 

H  -20 

and  conmo  type  J. 

TRARRY  (3,1) 

seconds 

F!0. 4 

21-30 

I  *  1  for  pre-planned  targets 

I  »  2  for  targets  of  opportunity 

1  =  3  for  priority  pre-planned 

TRARRY  (1,2) 

seconds 

FI  0.4 

31-40 

targets. 

TRARRY  (2,2) 

seconds 

FI  0.4 

41-50 

J  =  1  for  digital  conmo 

TRARRY  (3,2) 

i  seconds 

FI  0.4 

:  51-60  I 

1 

J  =  2  for  voice  conmo 

!  Note:  These  nominal  response  times  are 
not  to  include  time-of-fl ight.  ( TOF  is 
'  acicTed  in  COPE  itself  to  obtain  TRBAR). 


( 


i 

i 


i 


4.  Direct  Fire  Suppression  Data  Block  Input. 

When  reading  direct  fire  suppression  data  into  PREPMS  for 
transfer  to  TAPE  11,  the  first  card  (which  indicates  that  a  direct 
fire  suppression  data  record  is  to  be  read)  must  be  of  the  form: 

NEW  RECORD,  record  name,  4 

or 

NEW  REC,  record  name,  4 

where  record  name  is  the  name  of  the  direct  fire  suppression  record  to 
be  read  (see  section  5.3.4  for  direct  fire  suppression  record  names). 

When  using  the  TEMPORARY  option  with  COPE,  the  direct  fire 
suppression  data  is  headed  by  a  card  of  the  form: 

TEMPORARY  DIRECT  FIRE  SUPPRESSION 

or 

TEMPORARY,  OFTRE  SUPPR 


or 

TEMP,  OIRECT  FIRE  SUPPRESSION 
or 

TEMP.  DFIRE  SUPPR 

Tn  either  case  (whether  reading  direct  fire  suppression  data 
in  PREPMS  or  COPE),  the  remaining  cards  of  the  direct  fire  suppression 
data  are  as  follow: 


I 
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DIRECT  FIRE  SUPPRESSION  CARD  SET 


Card  No. 


DIRECT  FIRE  SUPPRESSION  CARD  SET 


Variable  name 


DFOOKL  (1,3) 

DFDOKL  (2,3) 
1 


DFDOKL  (8,3) 


columns 


Card  No.  3c 


description 


DFDOKL  (1,3)  is  the  probability 
that  direct  fire  from  the  target  at 
range  DFDOKL  (1,1)  kills  the  DO. 

If  NDFSP>8,  then  a  second  card  is 
needed  for  DFDOKL  (9,3)  through 
DFDOKL  (NDFSP.3) 
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5.  Random  Occurrence  Data  Block  Input. 

When  reading  random  occurrence  data  in  PREPMS  for  transfer 
to  TAPE  11,  the  first  card  (which  indicates  that  a  random  occurrence 
data  record  is  to  be  read)  must  be  of  the  form: 

NEW  RECORD,  record  name,  5 

or 

NEW  REC,  record  name,  5 


where  record  name  is  the  name  of  the  random  occurrence  record  to  be 
read  (see  section  5.3.5  for  random  occurrence  record  names). 

When  using  the  TEMPORARY  option  with  COPE,  the  random 
occurrence  data  is  headed  by  a  card  of  the  form: 

TEMPORARY,  RANDOM  OCCURRENCE  DISTRIBUTION 


or 

TEMPORARY,  RODIST 


or 

TEMP,  RANDOM  OCCURRENCE  DISTRIBUTION 


or 

TEMP,  RODIST 


In  either  case  (whether  reading  random  occurrence  data  in 
PREPMS  or  COPE),  the  remaining  cards  of  the  random  occurrence  data  are 
as  follow: 
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SET 


Card  No. 


Variable  name 


KNITS 

Format 

columns 

description 

Critical  time  for  laser  designation 
(i.e.,  the  length  of  the  time 
Interval  immediately  prior  to  impact 
during  which  the  target  must  be 
continuously  lased  in  order  to  have 
a  successful  Copperhead  mission). 


-52 


Variable  name 


an  its 


RNGPLS  (1) 
RNGPLS  (2) 

I 

I 

I 

* 

RNGPLS  (8) 


meters 


meters 


i 

meters 


format 


co  1  limns 


no. 4 
no. 4 

i 

i 

i 

i 

no. 4 


1-10 

11-20 

i 

i 

1 

» 

71-80 


description 


RNGPLS  (I)  is  the  upper  limit  of 
the  Ith  range  class  for  random 
occurrence  line  of  sight  data. 

Range  class  1  extends  from  zero 
to  RNG5LS  (1);  range  class  I  for  I>T 
extends  from  RNGPLS  (I)  to 
RNGPLS  (1+1). 
j  RNGPLS  ( I  )<-  RNGPLS  (1+1) 

[  If  NPLOSR >  8 ,  then  a  second  card 
must  be  used  to  contain  RNGPLS  (9) 
i  through  RNGPLS  (NPLOSR). 


Variable  name 

UNITS 

Format 

col  unins 

nescription 

PRBLOS  (1) 

no. 4 

1-10 

PRBLOS  (I)  is  the  probability 
that  a  single  vehicle  in  range 
class  I  is  in  view  of  the  00  for 

PRBLOS  (2) 

i 

no. 4 

i 

11-20 

the  final  TCRIT  seconds  of  the 
Copperhead  flight. 

■ 

If  NPLOSR  >8 ,  then  a  second  card 
is  needed  to  contain  PRBLOS (9) 

PRBLOS  (8) 

no. 4 

71-80 

through  PRBLOS(NPLOSR) . 

6.  PE  Data  Block  Input. 

When  reading  PE  data  in  PREPMS  for  transfer  to  TAPE  11,  the 
first  card  (which  indicates  that  a  PE  data  record  is  to  be  read)  must 
be  of  the  form: 


NEW  RECORD,  record  name,  6 


or 

NEW  REC,  record  name,  6 


where  record  name  is  the  name  of  the  PE  data  record  to  be  read  (see 
section  5.4  for  PE  record  names). 

When  using  the  TEMPORARY  option  with  COPE,  the  PE  data  are 
headed  by  a  card  of  the  form: 

TEMPORARY,  PEDATA 


or 

TEMP,  PEDATA 


In  either  case  (whether  reading  PE  data  in  PREPMS  or  COPE), 
there  is  an  optional  card  that  can  be  inserted  next: 

USE  TAPE  4 


If  this  card  is  used,  then  the  program  (PREPMS  or  COPE) 
reads  the  remaining  cards  of  the  PE  data  from  I/O  unit  4  instead  of  the 
normal  I/O  unit  5;  if  this  card  is  not  used,  then  the  PE  data  are  read 
from  I/O  unit  5.  In  either  case  (whether  I/O  unit  4  or  5  is  used),  the 
remaining  PE  data  cards  are  as  described  after  this  note: 

Note:  Because  the  PAM  program  (see  Chapter  16)  can  write  the 
PE  data  records  directly  to  TAPE  11  without  any  need  to  ri"i  PREPMS,  it 
is  very  unlikely  that  the  need  will  arise  to  use  PREPMS  (or-  COPE)  to 
read  PE  data  as  described  in  this  section;  however,  the  capability  is 
provided. 
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Variable  name 


UNITS 


description 


INDEX  (I,J,1) 

15 

1-5 

INDEX  (I,J,K)  =  10*(I-1 )+2*(J-l  )+K 
where  K  =  1 ,2 

J  *  1,2 . 5 

INDEX  (1,0,2) 

15 

i 

6-10 

! 

! 

i  i 

;  i 

j 

I  -  1,2 . 6 

The  values  are  read  two  to  a  card 
and  the  values  are  arranged  varying 

X  first,  then  J,  and  then  I. 

This  procedure  yields  a  set  of  30 

1  cards.  The  Nth  such  card  having  the 
values  (2N-1 )  and  2N  on  it  in  215 
format. 

The  index  array  is  used  to  access 

i 


!  The  index  array  is  used  to  access 
:  the  PETBL  array. 


7.  Posture  Data  Block  Input. 

When  reading  posture  data  in  PREPMS  for  transfer  to  TAPE  11, 
the  first  card  (which  indicates  that  a  Target  Posture  data  record  is  to 
be  read)  must  be  of  the  form: 

NEW  RECORD,  record  name,  7 


or 

NEW  REC,  record  name,  7 


where  record  name  is  the  name  of  the  target  posture  data  to  be  read  (see 
section  5.3.6  for  target  posture  record  names). 

When  using  the  TEMPORARY  option  with  COPE,  the  target  posture 
data  are  headed  by  a  card  of  the"  form: 

TEMPORARY,  TARGET  POSTURE  DISTRIBUTION 


or 

TEMPORARY,  TGTPSTDIST 
or 

TEMP,  TARGET  POSTURE  DISTRIBUTION 


or 

TEMP,  TGTPSTDIST 


In  either  case  (whether  reading  target  posture  data  in  PREPMS 
or  COPE),  the  remaining  cards  of  the  target  posture  data  are  as  follow: 
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POSTURE  OATA 


CARD  SET 


Card  No.  2 


Variable  name 

UNITS 

Format 

NRNGPS 

15 

col  umns 


Description 


1-5  Number  of  range  classes  used  for 

target  posture  data. 


Current  dimensions  require 
NRNGPSilO. 


i 


i 


i 


i 

} 

I 


I 


I 
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i 

i 


POSTURE  DATA 


CARO  SET 


Card  Mo. 


Variable  name 

UNITS 

Format 

hescription 

RNGPST  (1) 

meters 

no. 4 

! 

1-10 

RNGPST  (I)  is  the  upper  limit  of 
the  Ith  range  class  for  posture 

RNGPST  (2) 

meters 

no. 4 

11-20 

data. 

RNGPST  (3) 

\ 

1 

meters 

i 

i 

no. 4 

i 

21-30 

The  first  range  class  runs  from 
zero  to  RNGPST  (1);  the  Ith  range 
class  extends  from  RNGPST  (I)  to 

\ 

i 

1 

1 

i 

'  . 

!  i 

RNGPST  (1+1). 

1  Note  RNGPST  (I)^RNGPST  (1+1) 

RNGPST  (8) 

meters 

i  no. 4 

71-80 

Also,  if  NRNGPS > 8 ,  the  a  second 

1  card  is  required:  for  RNGPST  (9) 

:  through  RNGPST  (NRNGPS ) . 

Variable  name 

PSTTBL  (1,2) 

PSTT8L  (2,2) 

l 

I 

l 

PSTTBL  (8,2) 


UNITS 

Format 

columns 

description 

no. 4 

1-10 

PSTTBL  (1,2)  Is  the  probability 
that  the  target  is  fully  exposed 

no. 4 

11-20 

when  at  DO-to-target  range 

' 

t 

RNGPST  (I). 

1 

1 

i 

( 

As  usual,  if  NRNGPS>  8,  a  second 

no. 4 

j  71-80 

;  card  is  needed  for  PSTTBL  (9,2)  ! 

through  PSTTBL  (NRNGPS.2). 

8.  Invariant  Data  Block. 


When  reading  invariant  data  in  PREPMS  for  transfer  to  TAPE 
11,  the  first  card  (which  indicates  that  an  invariant  data  record  is 
to  be  read)  must  be  of  the  form: 

NE W  RECORD,  record  name,  8 


or 

NEW  REC,  record  name,  8 

where  record  name  is  the  name  of  the  invariant  data  record  to  be  read 
(see  section  5.3.7  for  invariant  data  record  names). 

Wien  using  the  TEMPORARY  option  with  COPE,  the  invariant 
data  is  headed  by  a  card  of  the  form: 

TEMPORARY,  INVARIANT 


or 

TEMP,  INVARIANT 


In  either  case  (whether  reading  invariant  data  in  PREPMS  or 
COPE),  the  remaining  cards  of  the  invariant  data  are  as  follow: 


1 


INVARIANT  DATA 


CARD  SET 


Card  No. 


3a  -  3t 


Variable  name 


RNGTTF  (J) 


TTF  (I,J,1) 

TTF  (1  ,0,2) 
TTF  (2,J,1) 
TTF  (2 , J .2) 
TTF  (3, J ,1 ) 
TTF  (3,0,2) 


col umns 


!  21-30 


i  51-60 


description 

RNGTTF  (J)  is  the  Ith  range  at 
which  probability  of  hit  data  is 
entered.  RNGTTF  (1)  3  0.0  and 
RNGTTF  (I )< RNGTTF  (1+1). 

TTF  (I,J,K)  is  the  probability 
!  of  hit  at  range  J  using  designator 
type  I  against  a  target  in  posture  K. 

I  »  1  for  GLLD 

I  =  2  for  MULE 

I  =  3  for  LTD 

K  =  1  for  fully  exposed 

K  *  2  for  hull  defilade  (turret 
exposed) 

There  will  be  NRNGTT  cards  of  this  type 
with  each  card  containing  the  same 
data  points  as  its  predecessor  but 
for  the  next  J  value. 

There  will  be  a  maximum  of  20  such 
|  cards. 


INVARIANT  DATA 


CARD  SET 


Card  Mo.  _ 5a 


- r 

Variable  name 

UNITS 

Format 

i  : 

j  columns  1 

^escri  ption 

PKTBL  (1,1) 

no. 4 

1-10 

PKTBL  (1,1)  is  the  probability 
of  kill  given  a  Copperhead  hit 

PKTBL  (2,1) 

no. 4 

11-20 

I 

against  target  type  I  in  a  fully 
exposed  posture , 

PKTBL  (3,1) 

no. 4 

21-30 

PKTBL  (4,1  ) 

no. 4 

|  31-40 

PKTBL  (5,1) 

no. 4 

41-50 

! 

I 

PKTBL  (6,1) 

no. 4 

j 

51-60 

PKTBL  (7,1) 

j  no. 4 

j  61-70 

( 

1 

I  ! 

I  1  ! 

! 


i 


j 


I 

! 

I 

I 

I 


i  | 
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INVARIANT  DATA  _ CARO  SET  Card  No.  5b 


Variable  name 

UNITS 

Format 

col  amns 

Description 

PKTBL  (1,2) 

no. 4 

1-10 

PKTBL  (1,2)  Is  the  probability 
of  kill  given  a  Copperhead  hit 

PKTBL  (2,2) 

no. 4 

11-20 

against  target  type  I  in  a  hull 
defilade  (turret  exposed) 

PKTBL  (3,2) 

no. 4 

21-30 

posture. 

PKTBL  (4,2) 

no. 4 

31-40 

PKTBL  (5,2) 

no. 4 

41-50 

PKTBL  (6,2) 

no. 4 

51-60 

PKTBL  (7,2) 

no. 4 

i 

61-70 

14.4.3  REPORT  RECORD  LIST  Directive.  The  third  type  of  input 
to  PREPMS  is  a  line  of  the  form: 

REPORT  RECORD  LIST 


or 

REP  REC  LIST 


Inserting  this  line  (card  or  card  image)  in  the  PREPMS  input 
will  cause  the  program  to  print  a  list  of  the  names  of  the  records  on 
TAPE  11  at  the  time  the  line  is  encountered. 

The  usual  practice  is  to  place  a  line  of  this  type  in  the  input 
after  all  of  the  option  word  records  and  data  block  records  so  that  the 
list  produced  will  include  all  of  the  records  created  by  the  current  run. 

An  example  of  the  list  produced  is  shown  in  Appendix  C. 

14.4.4  INTERPRET  PEDATA  Directive.  The  fourth  type  of  input 
to  PREPMS  is  a  line  of  the  form: 

INTERPRET  PEDATA 


Inserting  a  line  of  this  form  in  the  PREPMS  input  will  cause 
the  program  to  print  a  list  of  the  names  of  the  current  PE  data  records 
on  TAPE  11  as  well  as  the  values  of  the  nine  parameters  corresponding  to 
each  such  record  (see  section  5.4). 

14.5  PREPMS  Output. 

PREPMS  writes  to  two  files,  TAPE  11  and  TAPE  6  (also  called 
OUTPUT).  TAPE  11  receives  the  data  block  records,  the  option  word  records, 
the  record  named  OPTNNUMS  (which  is  automatically  maintained  by  PREPMS 
with  no  user  attention),  and  the  record  index  array  which  is  automatically 
maintained  by  the  CDC  word  addressable  mass  storage  file  facilities.  TAPE 
6  (usually  a  line  printer)  is  a  sequential  file  on  which  PREPMS  echoes 
the  inputs  that  create  the  data  block  records  and  option  name  records  as 
well  as  prints  the  lists  generated  by  INTERPRET  PEDATA  and  REPORT  RECORD 
LIST  directives. 

A  sample  of  PREPMS  output  (TAPE  6)  is  given  in  Appendix  C,  so 
further  discussion  is  not  given  here. 
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14.6  PREPMS  Diagnostic  Messages. 

Since  several  of  the  subroutines  used  by  PREPMS  are  similar  to 
those  used  in  COPE,  any  diagnostic  messages  not  found  in  this  section 
(which  gives  only  the  PREPMS-pecul iar  messages)  should  be  given  in  Chapter 
7. 


14.6.1  Messages  of  Informational  Nature  Not  Terminating  Program. 

1.  **PR£PMS**  NON-FATAL  WARNING!  YOU  HAVE  SEQUENCE  NUMBERS 
IN  COLS.  73-78  OF  TAPE5.  THEY  WILL  BE  REMOVED  BY  THE  PROGRAM;  HOWEVER,  THE 
RESULTS  MAY  BE  SUSPECT: 

This  message  is  generated  in  SEPRC2  and  is  caused  when  the 
computer  detects  editor  sequence  numbers  in  the  INPUT  file  (see  section  7.1). 

This  message  does  not  stop  the  program;  however,  it  is  very 
probable  that  the  wrong  data  has  been  used  if  this  message  is  printed. 

Great  care  should  be  taken  to  assure  that  the  OUTPUT  shows  the  correct 
(intended)  values  and  that  no  sequence  numbers  were  taken  as  input. 

Note  that  the  sequence  numbers  are  removed  only  from  those 
lines  entered  in  free  format.  All  lines  entered  as  formatted  data  will 
still  have  sequence  numbers  which  may  be  read  instead  of  the  intended 
data  (for  columns  73-78). 

To  avoid  this  problem,  one  should  always  use  an  80  character 
line  length  when  editing  the  input  file  for  PREPMS  (i.e. ,  F,CH=80  on  CDC). 

2.  **PREPMS**  THIS  IS  A  CREATION  RUN  FOR  RECORD  OPTNNUMS. 

This  message  is  not  really  a  diagnostic  but  merely  indicates  to 
the  user  that  this  run  of  PREPMS  creates  a  new  TAPE  11.  If  this  message 
is  not  present,  it  means  that  the  current  PREPMS  run  is  modifying  an 
existing  TAPE  11  rather  than  creating  a  new  one. 

14.6.2  STOPS  With  Messages  in  Day  Files. 

1.  STOP  IN  PREPMS:  ERROR  NUMBER  1. 

This  stop  occurs  when  the  program  has  read  an  input  card  which 
should  be  the  first  card  of  one  of  the  four  input  types  of  section  14.4, 
but  does  not  recognize  the  card  as  one  of  those  four  types. 

This  error  is  most  likely  to  happen  when  either  the  card  is 
mispunched  or  the  previous  input  set  (especially  if  it  was  type  1  or  type 
2  input)  has  the  wrong  number  of  cards. 
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.  STOP  IN  PREPMS:  ERROR  NUMBER  2. 


This  error  occurs  when  the  third  field  of  a  type  I  card  of  a 
type  1  input  is  not  a  number.  (That  is,  the  option  word  record  input 
type  starts  with  a  card  that  has  a  non-numeral  for  the  value  of  NREAD. 

See  section  14.4.1  for  the  correct  form  of  this  card  type). 

3.  STOP  IN  PREPMS:  ERROR  NUMBER  3. 

This  error  occurs  when  the  fourth  field  of  a  type  1  card  (the 
value  of  N0PT1)  of  a  type  1  input  is  not  a  number.  (See  section  14.4.1 
for  the  correct  form  of  this  card  type). 

4.  STOP  IN  PREPMS:  ERROR  NUMBER  4. 

This  error  occurs  when  the  first  field  of  a  type  2  card  of  a 
type  1  input  is  not  a  number.  Again,  see  section  14.4.1  for  the  correct 
form  of  this  card. 

5.  STOP  IN  PREPMS:  ERROR  NUMBER  5. 

This  error  occurs  when  the  second  field  of  a  type  2  card  of  a 
type  1  input  is  not  a  number.  See  section  14.4.1  for  the  correct  form  of 
this  card. 

6.  STOP  IN  PREPMS;  ERROR  NUMBER  6. 

This  error  occurs  when  the  third  field  of  the  first  card  of  a 
type  2  input  is  not  a  number.  See  section  14.4.2  (subsections  1  through 
8)  for  the  proper  first  card  form  for  this  input  type. 

7.  STOP  IN  PREPMS:  PROGRAM  TERMINATION. 

This  means  that  the  program  reached  the  end  of  a  file  on  TAPE  5 
(INPUT)  without  any  errors  detected.  It  is  the  message  that  accompanies 
a  successful  run,  but  of  course  it  is  no  guarantee  that  the  data  are 
correct  (only  that  they  are  formatted  in  a  valid  form). 


8.  STOP  IN  SEPRC2 :  ERROR  NUMBER  1. 


CHAPTER  15 


15.  PRBLOS  PREPROCESSOR 

The  PRBLOS  preprocessor  is  used  to  calculate  the  probability 
that  a  target  randomly  located  along  a  route  of  approach  within  a  certain 
designator-to-target  range  band  will  be  in  the  line-of-sight  of  the 
designator  for  at  least  the  final  critical  seconds  of  the  COPPERHEAD 
trajectory. 

This  chapter  gives:  (1)  the  mathematical  derivation  of  the 
method  for  computing  the  probability  mentioned  above,  (2)  a  description 
of  the  program,  (3)  a  glossary  of  program  variables,  (4)  description  of 
inputs,  and  (5)  description  of  outputs.  A  program  listing  along  with 
sample  inputs  and  the  resulting  outputs  are  given  in  Appendix  B. 

15.1  Method  For  Calculating  PRBLOS. 

For  a  particular  designator-to-target  range  band  (e.g.,  ranges 
2000m  to  3000m)  define  F  and  G  to  be  the  cumulative  distribution  functions 
for  in-view  and  out-of-view  segment  lengths  respectively.  That  is,  the 
probability  that  a  randomly  selected  LOS  segment  for  the  given  range  band 
is  of  length  less  than  or  equal  to  X  is  F(X);  the  probability  that  a 
randomly  selected  out-of-view  segment  in  the  given  range  band  is  of  length 
lessthan  or  equal  to  X  is  G(X). 

Let  tc  be  the  critical  time;  that  is  the  time  interval  at  the 
end  of  the  COPPERHEAD  trajectory  during  which  the  target  must  be  designated 
in  order  for  the  COPPERHEAD  to  track  and  hit  the  target.  Also,  let  vt  be 
the  target  velocity  (target  velocity  is  assumed  constant). 

Then  the  history  of  a  target's  exposure  can  be  thought  of  as  a 
sequence  of  alternating  in-view  and  out-of-view  segments.  For  example, 

the  sequence  f ] ,  gi ,  f2,  g2,  f3,  g3 - ,hn>  where  the  f-j's  are  in-view 

segment  lengths  forming  a  sample  from  a  population  of  segment  lengths 
distributed  according  to  the  cumulative  distribution  F,  the  gj's  are  out- 
of-view  segment  lengths  forming  a  sample  from  a  population  of  segment 
lengths  distributed  according  to  cumulative  distribution  G,  and  hn  is  the 
last  segment  which  is  either  an  fj  or  a  g,  depending  on  whether  the  final 
segment  is  in- view  or  out-of-view. 

Then  for  a  particular  target's  exposure  (i.e.,  in-view,  out-of¬ 
view)  history,  one  can  calculate  its  probability  of  being  in-view  as 
probability  target  is  in-view  =  fraction  of  target's  path  in- view  = 

N 

Ifi 

_ ifi _ 

N  M 

Z  fi  +  Z  9i 

i=l  i=l 

where  M  is  equal  to  either  N  or  N-l  depending  on  whether  the  last  segment  is 
respectively  out-of-view  or  in-view. 
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In  our  problem  though,  we  do  not  want  the  probability  that  the 
target  is  in-view,  but  rather  the  probability  that  it  is  in-view  and  will 
remain  in-view  for  the  next  tc  time  units.  This  means  that  the  target 
must  be  in  an  in-view  segment  and  be  at  least  tc*vt  distance  from  the  end 
of  that  segment.  The  probability  that  the  target  is  in  such  a  location 
is  equal  to  the  fraction  of  the  target's  path  that  consists  of  points 
that  are  in-view  and  at  least  a  distance  tc*v^  from  the  next  out-of-view 
segment. 

For  each  in-view  segment  either  (1)  f^  <_tc*vt  in  which  case 
that  in-view  segment  contributes  nothing  to  the  total  path  length  satisfying 
the  conditions,  or  (2)  f-j  >  tc*vt  distance  from  the  next  out-of-view  segment. 

Therefore,  we  have: 

probability  target  is  in- view  and  at  least  tc*vt  distance  from  next  out- 
of-view  segment  = 

fraction  of  target's  path  that  is  in-view  and  at  least  tc*vt  distance 
from  the  next  out-of-view  segment  = 

N 

£  max  {0,  f^-t  *vt) 

_ ifl _ 

N  M 

I  f-  *  E  9i 

i-i  i-i 


where  M  and  N  are  as  before  and  max  {0,  tj  -  tc*vt)  is  the  length 
contributed  by  the  ith  in-view  segment  to  the  total  path  length  that 
is  in-view  and  at  least  tc*vt  away  from  the  next  out-of-view  segment. 

Note:  max  {0,  f i -tc*vt }  means  that  the  ith  term  of  the 
sum  is  to  be  the  maximum  of  the  two  quantities  0  and  (f-j-tc*vt). 

Let  S-j  =  max  {0,  f-j-tQ*^}  then  the  S-j's  can  be  obtained 
by  sampling  f^'s  from  a  population  with  cumulative  distribution  F  and 
then  applying  the  formula  Sj  =  max  {0,  f-j-tc*vt}  •  This  is  equivalent 
to  sampling  from  a  population  with  cumulative  distribution  S  where: 

S(0)  =  F(tc*vt)  and 

S(X)  =  F(x  +  tc*vt)  for  x  >  0. 


Hence,  our  probability  that  the  target  is  in- view  and  at  least 
tc*vt  from  the  next  out-of-view  segment  can  be  written: 


1  Y  max  {0,  f.-t  *v.} 
N  L  ^  c  t 

i=l 


N  M 

IV  fi  +  IV  Si 


Now  to  obtain  an  overall  estimate  of  this  probability  (which  we 
call  PRBLOS)  we  can  imagine  that  we  let  our  target  wander  back  and  forth 
over  the  various  paths  in  the  given  range  band.  As  this  is  done,  N  -*■  00 
(and  also  M/N  1 )  so  that 

N 

£  f-j  (mean  of  f.  population) 

i=l 


M  M 

IV  q  g.  I  +  H  H  -*•  M  (mean  of  g.  population) 

N  i  N  M  f-  1  N  9  9  1 

N  ,  N 

1  £  max  (0,  f.-tc*vt}  =  Si'+Ms  (mean  of  si  P°Pu1ation) 


Therefore, 


PRBLOS  = 


Mf  +  Mg 


is  used  as  the  probability  that  a  vehicle  randomly  located  in  a  given  range 

band  is  in-view  (from  the  designator's  position)  and  will  remain  in-view  for 

at  least  t  time  units, 
c 


15.2  Description  of  PRBLOS  Program  and  Glossary  of  Variables. 

The  program  is  extremely  simple  and  consists  of  nothing  but  the 
steps  required  to  perforin  the  calculations  described  in  15.1  as  well  as 
to  read  the  input  and  print  the  results. 

The  program  can  be  summarized  as  four  main  steps : 

(1)  Read  the  input  for  the  next  case  and  print  it  for  checking 
purposes;  if  no  input,  stop. 

(2)  Form  the  modified  distribution  (the  one  with  cumulative 
distribution  function  S  in  section  15.1)  and  print  it. 

(3)  Calculate  the  means  of  the  three  distributions  F,  G,  and  S 
(i.e.,  Mf,  Mg,  Ms)  and  from  that  calculate  PRBLOS. 

(4)  Print  PRBLOS  and  return  to  step  (1)  to  see  whether  there 
is  another  case. 

The  subroutine  AVEL  of  the  program  computes  the  mean  of  a 
distribution  with  cumulative  distribution  function  F  by  using  the  formula: 

u  U 

Mf  =/  xf ( x ) dx  =  UF(U)-LF(L)  -J  F(x)dx 

where  f  is  the  probability  density  function  (i.e.,  f  =  F'  almost 
everywhere)  and  U  and  L  are  respectively  the  upper  and  lower  bounds  of 
the  distribution  (in  our  cases,  0<,L<U<°°). 

Since  F  is  defined  in  the  program  by  an  array  of  ordered  pairs 
(x-j,  F-j )  i  =  1,  2...K  where  F-j  =  probability  that  x  is  less  than  or  equal 
to  x^ ,  it  is  possible  to  approximate  the  right  most  integral  by: 

u  K-l 

(*)  /  F(x)dx  -  2 (xi+i"xi )(Fi+i+F. ). 

Hence,  the  subroutine  AVEL  calculates  the  mean  of  a  population 
with  cumulative  distribution  function  F  using  the  formula: 

K-l 

Mf  XK  FK  "  X1F1  '  1  £  (xi+Txi  ^  CFi+i+Fi )  - 

i  =  l 

The  actual  variable  names  used  in  the  program  are  different  from 
those  used  in  sections  15.1  and  15.2;  however,  they  are  defined  in  the 
variable  glossary  so  understanding  should  be  fairly  easy. 
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1 5 . 3  PRBLOS  Inputs . 

For  each  case  that  is  to  be  run  with  the  PRBLOS  program, 
a  set  of  input  cards  (or  card  images)  composed  of  card  types  1 
through  5b  must  be  prepared.  Multiple  cases  can  be  run  by  simply 
stacking  card'sets  for  the  various  cases  one  after  another.  The 
first  card  of  each  case  has  room  (columns  21  through  80)  for  an  iden¬ 
tifying  alphanumeric  string  which  is  reproduced  on  output  for 
easier  case  identification.  The  program  runs  all  cases  until  it 
either  runs  out  of  input  or  encounters  an  illegal  input  value. 

Since  the  normal  use  of  the  PRBLOS  program  is  to 
calculate  the  values  to  fill  the  RANDOM  OCCURRENCE  Data  Block 
of  COPE  (in  particular  the  PRBLOS  array),  each  case  run  of  the 
PRBLOS  program  corresponds  to  a  given  terrain,  target  velocity, 
and  range  band  combination.  For  consistency,  the  PRIV  data  for 
PRBLOS  should  be  obtained  from  the  same  source  as  the  SEGLOS  data 
for  COPE.  (Indeed,  there  is  no  reason  why  for  a  given  terrain 
the  same  values  cannot  be  used  for  PRIV ( 1,1)  as  for  SEGLOS  (1,1) 
and  for  PRIV(I,2)  as  for  SEGLOS  (I,J)  in  the  (J-l)th  range  band.) 
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TGTVEL,  TC,  A 


CARD  SET 


CARD  NO. 


VARIABLE  NAME 


UNITS 


FORMAT 


COLUMNS 


DESCRIPTION 


TGTVEL 


meters /sec. 


FIO. 4 


1  -TO 


The  velocity  of  the  target 


TC 


seconds 


FIO. 4 


11-20 


The  critical  time 


A(l) 


AIO 


21-30 


A(l)  through  A{ 6)  can  be  used  to  hold  up  to 
60  characters  of  case  heading  which  are  copied 
from  this  card  to  the  first  output  line  of 
each  case.  This  has  no  effect  on  calculations 
but  enables  the  user  to  label  the  cases. 


A(2) 
A  ( 3 ) 
A  ( 4 ) 
A(5) 
A(6) 


AIO 

AIO 

AIO 

AIO 

AIO 


31-40 

41-50 

51-60 

61-70 

71-80 
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NIV 


CARD  SET 


CARD  NO. 


VARIABLE  NAME 


UNITS 


FORMAT 


COLUMNS 


DESCRIPTION 


NIV 


15 


1-5 


This  is  the  number  of  points  to  be  read 
to  describe  the  cumulative  in-view  segment 
length  distribution. 

NIV  controls  reading  of  PRIV: 

PRIV  (1,1)  for  1=1,2. ...NIV 
PRIV  (1,2)  for  1-1 ,2. . . ,N1V 


NOTE:  Current  program  dimensions  require 
NIV  <  20. 
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Pftiv  g, 2) 


CARD  SET 


CARD  NO.  3 


VARIABLE  NAME 

UNITS 

FORMAT 

COLUMNS 

DESCRIPTION 

PRI V( 1 ,2) 
PRIV(2,2) 
PRIV(3,2) 
PRIV(4,2) 
PRIV (5,2) 
PRIV(6,2) 
PRIV(7,Z) 
PRI  V  ( 8 ,2 ) 


meters 

meters 

meters 

meters 

meters 

meters 

meters 

meters 


PRIV  Cl *2)  is  the  in-view  segment  length 
corresponding  to  cumulative  probability 
PRIV(I.I) 

NOTE: 

PETV(I,2)  <  PRIVO+1,2)  for 
I  =  1,2 . NIV-1 


If  NIV>8,  then  an  additional  card  (or  two) 
is  needed  for  PRIV(9,2)  through 
PRI V(NI V ,2) .  The  additional  card(s)  have 
8F10.4  format. 


VARIABLE  NAME 


UNITS 


FORMAT 


COLUMNS 


DESCRIPTION 


NOOV 

15 

1-5 

NOOV  is  the  number  of  points  to  be  read  to 
describe  the  cumulative  out-of-view  segment 
length  distribution. 

NOOV  controls  reading  of  PROOV: 

PROOV(I.l)  for  1=1 ,2..., NOOV 

PROOV (I ,2)  for  1=1, 2..., NOOV 

NOTE:  Current  dimensions  require 
NOOV  <  20. 


VARIABLE  name 

UNITS 

FORMAT 

COLUMNS 

PROOV(I.l)  is  the  probability  that  a  randomly 
chosen  out-of-view  segment  has  length 
less  than  or  equal  to  PR00V(I,2). 

NOTE: 

PROOV(I.l)  <  PROOV  (1+1,1)  for 

I  =  1,2 . N00V-1; 

0  <.  PROOV  (1 ,1 )  <_  1.0  for 
I  =  1,2...,  NOOV;  and 
PROOV  (NOOV  ,1 )  =  1.0 

If  NOOV  >  8,  then  an  additional  card(or  two) 
is  needed  for  PR00V(9,1)  through  PR00V(N00V,1 ) . 
The  additional  card(s)  should  have  8F10.4 
format. 

PR0QV(I,1)  and  PR00V(I,2)  correspond  to  a 
point  on  the  cumulative  distribution 
G  of  section  15.1  (a  point  with  coordinates 
(PR00V(I,2)  ,PR00V(I,1))  in  the  usual  notation. 


r 


PROQVf  1 .2) _ CARD  SET 


CARD  NO. _ Sb 


VARIABLE  NAME 


UNITS 


FORMAT 


COLUMNS 


DESCRIPTION 


PROOVtl ,2)  meters 
PROOV(2,2)  meters 


F10.4  1-10 

F10.4  11-20 


PR00V(I,2)  is  the  out-of-view  segment 
length  corresponding  to  emulative 
probability  PROOV  (1,1). 


t 


PR00V(3,2) 

PR00V(4,2) 

PROOV(5,2) 

PR00V(6,2) 

PR00V(7,2) 

PR00V(8,2) 


meters 

meters 

meters 

meters 

meters 

meters 


F10.4 

21-30 

F10. 4 

31-40 

F10. 4 

41-50 

F10.4 

51-60 

o’ 

r-+ 

u. 

61-70 

F10.4 

71-80 

NOTE: 

PR00V(I ,2)  <  PROOV  (1+1,2)  for 
I  =  1 ,2,. . . , N00V-1 ; 

0.0  <  PROOV (1, 2)  <  1.0  for 
1  =  1,  2 . NOOV. 


If  NOOV  >  8,  then  an  additional  card 
(or  two)  is  needed  for  PR00V(9,2)  through 
PROOV (NOOV ,2 ) .  The  additional  card(s) 
have  8F10.4  format. 
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15.4.1  Output.  The  output  of  the  PRBLOS  program  is  very  brief 
and  easy  to  understand. 

For  each  case  run,  the  first  line  of  output  prints  the  case 
identifier  (if  any).  The  next  line  prints  the  target  velocity  and  critical 
time  values.  Then  comes  the  PRIV  array  preceded  by  NIV.  Next  the  PROOV 
array  preceded  by  NOOV  and  the  PRIVM  array  preceded  by  NIVM.  Finally,  it 
prints  the  average  segment  lengths  of  the  three  distributions  and  the 
PRBLOS  value  followed  by  the  words  "END  OF  CASE". 

In  the  special  case  that  tc*V£  is  greater  than  the  longest 
possible  in-view  segment,  a  message  to  that  effect  is  printed  along  with 
the  value  of  PRBLOS  (namely,  0.0).  In  this  case,  the  PRIVM  array  is  not 
pri nted. 


Note  that  PRBIVM  is  labeled  PRBLOS  when  printed.  (This  is 
because  PRBIVM  is  a  second  choice  name  for  PRBLOS  used  only  because  the 
program  card  name  PRBLOS  prevented  the  use  of  a  variable  PRBLOS  in  the 
program). 


A  program  listing  as  well  as  sample  input  and  output  for  PRBLOS 
is  contained  in  Appendix  B. 

15.4.2  Diagnostic  ("STOP")  Messages  in  Dayfile. 

1.  STOP  END  OF  INPUT. 

This  message  means  that  the  program  has  encountered  the  end  of 
file  of  TAPE5  (INPUT).  This  is  the  normal  program  termination  message, 
but  of  course,  it  is  no  guarantee  that  the  results  are  correct. 

2.  STOP  NIV>20  EXCEEDS  DIMENSIONS  OF  PRIV  ARRAY. 

This  message  means  the  user  attempted  to  read  in  an  NIV  value 
greater  than  20.  It  may  occur  because  NIV  is  not  right  justified  in 
columns  1-5  of  its  input  card.  Of  course,  it  may  also  occur  if  NIV  is 

really  greater  than  20;  if  this  is  the  case,  then  the  user  must  either 

use  fewer  points  to  describe  PRIV  or  redimension  PRIV  in  the  program  (and 
change  N1  in  first  call  of  AVEL.  Redimensioning  of  PRIVM  and  changing  N1 
in  the  third  call  of  AVEL  may  also  be  required). 

3.  STOP  N00V>20  EXCEEDS  DIMENSIONS  OF  PROOV  ARRAY. 

This  message  means  the  user  attempted  to  read  in  an  NOOV  value 
greater  than  20.  It  may  occur  because  NOOV  is  not  right  justified  in 
columns  1-5  of  its  input  card.  Of  course,  it  may  also  occur  if  NIV  is 

really  greater  than  20;  if  this  is  the  case,  then  the  user  must  either 

use  fewer  points  to  describe  PROOV  or  redimension  PROOV  in  the  program 

(and  change  N2  in  the  second  call  of  AVEL). 
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CHAPTER  16 


16.  PAM  PREPROCESSOR 

Unlike  the  other  programs  documented  in  this  report  (COPE, 

PREPMS,  and  PRBLOS),  the  PAM  program  was  not  written  by  the  author  of 
this  report.  Since  the  author  (Michael  Starks,  GWD,  AMSAA)  of  PAM  will 
document  it  in  a  separate  report,  this  chapter  is  limited  to  a  brief 
explanation  of  the  program's  purpose  and  a  description  of  the  input. 
Appendix  A  contains  a  program  listing  as  well  as  sample  inputs  and  outputs. 

16.1  General  Description  of  PE  Program  (PAM). 

The  PAM  program  is  used  to  compute  the  probability  of  engagement 
of  the  target  by  the  COPPERHEAD  seeker.  More  precisely,  probability  of 
engagement  (PE)  is  the  probability  that  the  COPPERHEAD  seeker  receives 
enough  reflected  laser  energy  from  the  target  for  the  COPPERHEAD  round  to 
initiate  maneuver  toward  the  target  and  that  the  target  is  within  the 
maneuver  footprint  of  the  COPPERHEAD. 

The  PAM  model  produces  a  table  of  4200  PE  values  (6  cloud 
ceiling  altitudes  x  10  meteorological  visibility  limits  x  5  delay  times  x 
7  designator-to-target  ranges  x  2  "MUTS"  factors).  (The  multi-unit  target 
factor  ("MUTS"  factor)  allows  TLE  to  be  reduced  when  the  predicted  impact 
point  is  bracketed  by  a  column  of  target  vehicles.) 

Such  a  table  then  has  PE  values  as  a  function  of  cloud  ceiling, 
visibility  limit,  delay  time,  MUTS  factor,  and  designator-to-target  range. 
In  addition,  the  set  of  PE's  in  the  table  is  a  function  of  the  9  parameters 
mentioned  in  section  5.4  (namely,  nominal  response  time,  designator  type 
(power),  target  velocity,  gun-target  range,  reflectivity  of  target,  angle 
T,  deflection  bias  (distance  between  footprint  centroid  and  target  path 
point  of  closest  approach),  target  heading,  and  seeker  sensitivity). 

Hence,  for  each  different  combination  of  values  of  the  9  parameters  a 
different  set  of  PE  values  is  needed  which,  in  turn,  requires  another  run 
of  the  PAM  program. 

The  PAM  program  includes  the  code  mentioned  in  section  5.4  that 
generates  PE  data  block  record  names  from  the  values  of  the  9  parameters. 
The  subroutine  PENAM2  is  included  in  PAM  and  is  identical  to  the  PE NAME 
subroutine  in  COPE  and  PREPMS  except  for  the  change  in  name  and  the  fact 
that  the  data  statement  for  the  XVALUE  array  is  included  in  P ENAM2  rather 
than  in  a  separate  BLOCK  DATA  subprogram  as  in  COPE  and  PREPMS.  The 
error  stops  with  messages  produced  by  PENAM2  correspond  to  those  for 
PENAME  as  explained  in  section  7.5. 


Assuming  that  the  user  runs  PAM  with  values  of  the  9  parameters 
that  are  permitted  by  PENAME  (see  section  5.4  and  discussion  of  XVALUE 
array),  then  a  PE  DATA  record  name  is  generated.  The  PE  values  are 
loaded  in  the  arrays  PE  (for  writing  to  TAPE  11  as  a  PE  data  record  for 
use  by  COPE)  and  PENG  (for  writing  to  TAPE  6  (output)  to  provide  a  hard 
copy  of  the  PE  values). 

In  order  that  the  values  written  to  TAPE  11  are  accessible  by 
COPE,  of  course,  it  is  necessary  to  catalog  TAPE  11  and  use  it  with  the 
COPE  runs.  The  interface  between  PAM  and  COPE  has  been  covered  in  section 

5.4. 


The  output  of  PAM  consists  mainly  of  the  inputs  which  are  echoed 
for  checking  purposes  (some  of  the  angles  are  converted  to  radians  before 
being  printed).  The  PE  values  are  printed  in  70  groups  of  60  (6  cloud 
ceiling  altitudes,  10  visibility  limits)  with  each  group  corresponding  to 
a  particular  designator-to-target  range,  time  delay,  and  MUTS  factor 
combination. 

A  program  listing  together  with  sample  inputs  and  outputs  is 
included  in  in  Appendix  A. 

16.2  PAM  Inputs. 

The  PAM  program  takes  all  its  inputs  in  free  format  (in  COC 
terminology,  it  uses  list-directed  reads).  This  means  that  on  each  card 
in  the  following  description  that  takes  more  than  one  variable,  the  values 
of  the  variables  are  punched  one  after  another  with  commas  between 
successive  values.  (See  sample  input  in  Appendix  A). 
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ETH 


CARP  SET 


CARD  NO 


VARIABLE  NAME 


DESCRIPTION 


ETH  is  the  energy  threshold. 
That  is,  the  amount  of  energy/ 
area  that  must  reach  the  seeker 
to  initiate  maneuver. 


COLUMNS  ! 


ULSCKIPTIuN 


Taryet  head i r.g.  The  angle  between 
the  gun-to-taryet  line  and  the 
target  path  when  .neasured  counter¬ 
clockwise  from  the  yun-target  line. 

Point  of  closest  approach  (deflection 
bias).  This  is  the  distance  between 
the  footprint  centroid  and  the  closest 
point  on  the  target's  path  to  the 
centroid. 


AZDT,  V,  RHO,  CD,  TR  CARD  SET 


CARD  NO. 


VARIABLE  NAME 


UNITS 


FORMAT 


COLUMNS 


DESCRIPTION 


AZDT 


V 

RHO 

ED 


Degrees 


Meters/Sec 


Mil  1 i joules 


Free 


Free 

Free 

Free 


!  AZDT  is  the  angle  T  (that  is,  the 
angle  between  the  designator-target 
line  and  gun-target  line  measured 
counter-clockwise  from  the  gun- 
target  line.)* 

V  is  the  target  velocity. 

RHO  is  the  target's  reflectivity. 

Designator  energy. 


TR  Seconds  Free  J  Nominal  respone  time  (time  from 

,  DO's  call  for  fire  to  expected 

j  round  arrival.  It  includes  time- 

!  of-fl ight  in  this  case. 

J  *Note:  AZDT  is  the  nominal  angle 
T;  that  is,  the  angle  between  the 
designator-target  line  and  the  gun 
target-line  when  TR  seconds  have 
passed  since  DO's  call  for  fire. 
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J 


VARIABLE  NAME 


UNITS 


FORMAT 


COLUMNS 


DESCRIPTION 


1 

_  ! _ 

NK 

Free 

NK  is  the  Monte  Carlo  sample 
size  used  in  the  program. 

RNG 

Meters 

Free 

| 

Gun-to-taryet  range  (must  he  the 
range  For  which  Footprints  are 
supplied). 

ACCX 

Meters 

Free 

1 

ACCX  is  the  COPPERHEAD  total 
delivery  error  standard  deviation 
in  the  deFlection  direction.* 

ACCY 

Meters 

Free 

1 

| 

ACCY  is  the  COPPERHEAD  total 
delivery  error  standard  deviation 
in  the  range  direction.* 

*Note:  These  are  the  delivery 
error  standard  deviations  For 
unquided  COPPERHEAD. 

IDRMN ,  I  DR  MX ,  IVMX 


CARD  si:t 


CARD  tJO 


7 


VARIABLE  NAME 

UNITS 

FORMAT 

COLUMNS 

T 

DESCRIPTION 

I  DRUM 

Km 

Free 

f*i nimur.  desi gnator-to-t ar get 
range. 

IDRMX 

Kiii 

Free 

Maxi  nun  desi gnat or -to- tar get 
range. 

IVMX 

Kn 

1 

Free 

Maximum  visibility  range. 

I 

5 


i 

i 


I 

i 
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■i 

v 


N I 


CARD  SET 


CARD  NO. 


8a 


variable  name 

UNITS 

:  FORMAT 

— [ - 

COLUMNS 

_ 

DESCRIPTION 

1 

MI  (J ) 


Free 


N I ( J )  is  the  number  of  points 
used  to  describe  ti.e  maneuver 
footprint  for  the  Jth  altitude. 


i  J  *  1  for  highest  altitude 
j  2  for  second  hiyhest  altitude 


6  for  lowest  altitude 

The  six  altitudes  for  which 
footprints  are  entered  are  the 
six  altitudes  used  for  cloud 
ceiling  altitudes  in  COPE 
weather  data. 

Note  that  there  will  be  a  set  of 
cards  8a,  3h,  8c  for  each  footprint 
for  a  total  of  six  such  sets  in  all. 
They  must  be  input  in  order  of 
ascending  J  1  s . 

With  current  dimensions 
NI (J )  <  11  for  all  J. 


i 
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THEMH 


CARD  SET 


CARD  NO.  8b 


VARIABLE  NAME 


UNITS 


FORMAT 


COLUMNS 


DESCRIPTION 


THEMH (1,J) 

degrees 

free 

THEMH ( 2, J) 

degrees 

free 

THEMH ( 3, J) 

degrees 

free 

THEMH(4,J) 

degrees 

free 

THEMH ( 5, J) 

degrees 

free 

THEMH ( 6, J ) 

degrees 

free 

THEMH ( 7,  J) 

degrees 

free 

THEMH ( 8, J) 

degrees 

free 

THEMH ( 9, J) 

degrees 

free 

THEMH(IO.J) 

degrees 

free 

IHEMH(11,J) 

degrees 

free 

THEMH(I.J)  is  the  angle  used  to  represent 
the  Ith  point  on  the  boundary  of  the  Jth 
footprint. 

Note  that  the  Jth  footprint  is  represented 
by  a  set  of  points{(p.,  8.)}  in  polar  coordin¬ 
ates,  where  7  1 

ei  *  THEMN(I.J) 

Oj  =  DISMH(I.O). 

THEMH (1 ,J)  =  0.0 

THEMH(NI(J),  J)  =  180.0 

The  angles  are  measured  off  the  ray  in  the 

positive  range  direction  from  the  centroid 

of  the  footprint. 


Because  the  footprint  is  symmetric  about  the 
range  axis,  only  one  half  of  it  is  read  in. 
It  is  for  this  reason  that  the  THEMH (I ,J) 
values  do  not  exceed  180  degrees. 


Also  note  that 
THEMH(I.J)  <  THEMHO+l.J) 
for  I  =  1  ,Z . N I  ( J  )  -  1 


If  N I ( J )  <  11,  then  only  NI(J)  entries  occur 
on  this  card  rather  than  the  11  entries 
shown. 
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APPENDIX  A 


LISTING  AND  SAMPLE  CASE  OF  PAM 


This  appendix  contains: 

(1)  A  listing  of  the  FORTRAN  code  for  the  PAM  program.  In 
addition  to  the  routines  in  this  listing,  PAM  also  uses  the  function 
URAN31  which  is  included  in  the  COPE  listing  in  Appendix  D. 

(2)  Three  sets  of  sample  case  input  for  PAM. 

(3)  Three  sample  runstreams  for  PAM  (one  corresponding  to  each 
set  of  sample  input). 

(4)  Sample  output  created  by  running  PAM  with  the  first  set  of 
sample  input. 

Note:  The  column  numbers  included  in  some  of  the  listings  in 
this  appendix  are  not  a  part  of  the  program  code,  the  data,  or  the  output, 
but  are  provided  only  for  the  reader's  convenience. 
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APPENDIX  B 

LISTING  AND  SAMPLE  CASE  OF  PRBLOS 
This  appendix  contains: 

(1)  A  listing  of  the  FORTRAN  code  for  the  PRBLOS  program. 

(2)  One  set  of  sample  inputs  for  PRBLOS. 

(3)  One  sample  runstream  for  PRBLOS. 

(4)  Sample  output  created  by  running  PRBLOS  with  the 
sample  input. 

Note:  The  column  numbers  included  in  some  of  the  listings 
in  this  appendix  are  not  a  part  of  the  program  code,  the  data,  or  the 
output,  but  are  included  only  for  the  reader's  convenience. 
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LI  ST  INC  AND  SAMPLE  CASE  OF  PREPMS 

This  appendix  contains: 

(1)  A  listing  of  the  FORTRAN  code  for  the  PREPMS  program.  In 
addition  to  the  routines  in  this  listing,  PREPMS  also  uses  the  functions 
IDCHAR  and  NUMRIC  and  the  subroutine  PENAME  which  are  included  in  the 
COPE  listing  in  Appendix  D. 

(2)  One  set  of  sample  inputs  for  PREPMS. 

(3)  One  sample  runstream  for  PP.EPMS. 

(4)  Sample  output  created  by  running  PREPMS  with  the  sample 
input  (and  with  the  records  created  by  the  three  sample  cases  of  PAM 
already  written  to  TAPE  11). 

Note:  The  column  numbers  included  in  some  of  the  listings  in 
this  appendix  are  not  a  part  of  the  program  code,  the  data,  or  the  output, 
but  are  included  only  for  the  reader's  convenience. 
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APPENDIX  D 


LISTING  AND  SAMPLE  CASE  OF  COPE 

This  appendix  contains: 

(1)  l\  listing  of  the  FORTRAN  code  for  the  COPE  program. 

(2)  One  set  of  sample  case  inputs  for  COPE. 

(3)  One  sample  runstream  for  COPE. 

(4)  Sample  output  created  by  running  COPE  with  the  sample 
input  (and  with  the  TAPE1 1  created  by  previous  PAM  and  PREPMS  sample  case 
runs).  The  output  produced  on  TAPES  by  this  run  (for  cases  1  and  2)  is 
included  in  Listings  7-1  and  7-2  of  section  7.6. 

Note:  The  column  numbers  included  in  some  of  the  listings  in 
this  appendix  are  not  a  part  of  the  program  code,  the  data,  or  the  output, 
but  are  included  only  for  the  reader's  convenience. 
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NOTATIONAL  CONVENTIONS 

In  chapters  4,  5,  and  14  of  this  report,  the  content  of  input 
cards  is  sometimes  displayed  with  underlining.  This  underlining  serves 
only  to  distinguish  that  which  goes  on  the  card  itself  from  the  remainder 
of  the  text;  no  actual  underlining  is  punched  on  any  of  the  input  cards 
themsel ves. 

Items  which  are  displayed  in  capital  letters  (with  underlining) 
in  the  description  of  a  card  type  are  to  be  copied  literally,  letter-for- 
letter  onto  the  input  card  of  that  type.  Items  displayed  in  lower  case 
letters  represent  positions  on  the  card  at  which  substitutions  are  to  be 
made  either  from  a  list  of  allowed  alternatives  listed  (in  capital  letters) 
in  the  descriptive  text  or  by  supplying  an  appropriate  numerical  value. 

In  the  lists  of  character  strings  allowed  as  substitutions  for  option  words, 
only  the  underlined  (capital)  characters  are  used. 

Similary,  in  chapter  7  where  various  messages  and  error  prints 
are  described,  the  capitalized,  underlined  part  is  printed  as  shown  (but 
without  the  underlining)  whereas  the  lower  case  part  describes  or 
substitutes  for  text  which  may  vary  from  occasion  to  occasion. 
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APPENDIX  F 


GLOSSARY  OF  ABBREVIATIONS 


BCS 

Battery  Computer  System 

CDC 

Control  Data  Corporation 

COPE 

(1)  Combat  Operational  Performance  Evaluation 

(2)  COPPERHEAD  Operational  Performance  Evaluation 

Df  ID 

Digital  Message  Device 

D.O.  ,  DO 

(1)  Designator  Operator 

(2)  DO  as  in  FORTRAN  DO-LOOP 

OT  II 

Development  Test  II 

FDC 

Fire  Direction  Center 

GLLD 

Ground  Laser  Location  Designator 

HE 

High  Explosive 

IMSL 

International  Mathematical  and  Statistical  Library 

LDWSS 

Laser  Designator  Weapon  System  Simulation 

LOS 

Li ne-of-Sight 

LTD 

Laser  Target  Designator 

MULE 

Modular  Unit  Laser  Equipment 

OT  II 

Operational  Test  II 

PAM 

Probability  of  Acquisition  and  Maneuver 

PE 

Probability  of  (Seeker)  Engagement 

PRBLOS 

Probability  of  Li ne-of-Sight 

PREPMS 

Preprocessor  of  Mass  Storage  File 

TLE 

Target  Location  Error 

USAFAS 

US  Army  Field  Artillery  School 
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